Staff

Check staff availability

Returns, for each staff member (the whole team, or the ones selected by staffIds, tags, collectionId or search), whether they have commitments overlapping the queried window and which ones, typed: order lines, internal services, declared absences and blocking incidents.

Tool

filmo_staff_availability_check

Readstaff:read

staff:read
120/min + 30/min availability
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_staff_availability_check",
    "arguments": {
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z"
    }
  }
}

{
  "structuredContent": {
    "data": [
      {
        "resourceId": "reso_8f2a1c",
        "name": "Example",
        "available": true,
        "commitments": [
          {
            "kind": "order",
            "orderId": "orde_8f2a1c",
            "orderNumber": "<orderNumber>",
            "label": "Example",
            "startDate": "2026-09-01T08:00:00Z",
            "endDate": "2026-09-01T08:00:00Z"
          }
        ]
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

Unlike /api/v1/availability/check, the response is NOT stock arithmetic: a person has no pool, they are either free or on a specific job. A requested identifier that does not exist comes back as a per-item error. Idempotent query (POST because of the structured body). Shares the availability quota of 30 req/min.

Arguments

startDatestring<date-time>Required

Start of the window to check (ISO 8601 with offset).

endDatestring<date-time>Required

End of the window to check (ISO 8601 with offset); must be later than startDate.

tagsstring[]

Only resources carrying ALL these tag identifiers.

Limits: min 1 items, max 50 items, each min length 1, each max length 100

collectionIdstring

Only resources in this collection.

Limits: min length 1, max length 100

searchstring

Free-text search on the name.

Limits: min length 1, max length 200

staffIdsstring[]

Restrict the answer to these staff members (1-100). An identifier that does not exist comes back as a per-item error.

Limits: min 1 items, max 100 items, each min length 1, each max length 100

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

Sample prompts

Which crew members are free on 20 January?

The same operation by REST

This tool runs POST /api/v1/staff/availability.

Staff
Check staff availability
Returns, for each staff member (the whole team, or the ones selected by staffIds, tags, collectionId or search), whether they have commitments overlapping the queried window and which ones, typed: order lines, internal services, declared absences and blocking incidents.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

Sample prompts

The same operation by REST

Related pages

Check staff availability

Safe writes

Errors