# contractorOps.titleChange.plan

Plan a contractor title change from the current agreement. Returns the current title, organization-local today, pending or later agreement, and every signer carried forward with whether an inactive member needs replacement; no document is sent or saved.

`GET | POST /api/v1/accounting/contractorOps.titleChange.plan`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_contractor_ops_title_change_plan`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `contractorId` | string (ID) | Yes | The ID of a contractor, from contractors.list. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/contractorOps.titleChange.plan \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'contractorId=4d5e6f7a-8b9c-4d0e-8f1a-2b3c4d5e6f7a'
```

Reference page: https://app.getoatmilk.com/docs/api/contractorOps.titleChange.plan