# contractorOps.roles.versions

List a job role's versions, newest first, with roleId: what the role said and paid at each version (title, level, department, type, summary, responsibilities, requirements and pay band), which parts changed from the version before (title, level, department, type, description or pay), who changed it and when, and how many sent agreements were made on that version. Every change to those parts is a new version, and an agreement keeps the version and pay it was made with.

`GET | POST /api/v1/accounting/contractorOps.roles.versions`

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

MCP tool: `accounting_contractor_ops_roles_versions`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `roleId` | string (ID) | Yes | The ID of the related record. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/contractorOps.roles.versions \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'roleId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10'
```

Reference page: https://app.getoatmilk.com/docs/api/contractorOps.roles.versions