`requests.people`

List the eligible people (possible assignees) for one record: active people who can access it and help resolve its next action, each with the userId that requests.create takes as assigneeUserId. Includes the bound contractor for their own timesheet or profile.

GETPOST/api/v1/accounting/requests.people

Permissions

accounting:read

Who can call it

admin, finance, contributor

Retries

Safe to retry: it only reads

MCP

accounting_requests_people

Fields

subjectTypeenumRequired
The kind of record this is about, such as entry, invoice or mail.
entrysubmissionmailstatementcontractortimesheetcompliance_itemintake_item
subjectIdstring (ID)Required
The ID of the record this is about.

curl -G https://app.getoatmilk.com/api/v1/accounting/requests.people \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'subjectType=entry' \
  --data-urlencode 'subjectId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/requests.people?subjectType=entry&subjectId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", {
  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/requests.people",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "subjectType": "entry",
        "subjectId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    },
    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/requests.people

curl -G https://app.getoatmilk.com/api/v1/accounting/requests.people \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'subjectType=entry' \
  --data-urlencode 'subjectId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/requests.people?subjectType=entry&subjectId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", {
  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/requests.people",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "subjectType": "entry",
        "subjectId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    },
    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