`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.

GETPOST/api/v1/accounting/contractorOps.roles.versions

Permissions

accounting:read

Who can call it

admin, finance

Retries

Safe to retry: it only reads

MCP

accounting_contractor_ops_roles_versions

Fields

roleIdstring (ID)Required
The ID of the related record.

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'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/contractorOps.roles.versions?roleId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/contractorOps.roles.versions",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "roleId": "7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Response

{
  "data": { … }
}

Try it

Checks your input with this action’s real schema and answers like the API, with synthetic data. No key needed, and nothing changes.

Input

GET/api/v1/accounting/contractorOps.roles.versions

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'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/contractorOps.roles.versions?roleId=7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/contractorOps.roles.versions",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "roleId": "7f0f6c1e-1c1f-4b5e-9c8d-2f5e8e3c1a10",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Fields

Example

Try it