Staff

Get a staff member

Returns a staff member by its identifier.

Tool

filmo_staff_get

Readstaff:read

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_staff_get",
    "arguments": {
      "staffId": "staf_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "fullName": "Example",
      "staffType": "employee",
      "collectionId": "coll_8f2a1c",
      "collectionName": "Example",
      "hasDrivingLicense": true,
      "showInPlanner": true,
      "externalRef": "<externalRef>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generated from the schema

The projection is the same as the listing, and that is deliberate: the internal record carries personal and employment data —emergency contact, contract type and hours, internal and external cost, platform role— that is not published to an integrator. This operation exists to resolve an identifier without paginating the whole listing, not to widen what is seen of a person.

Arguments

staffIdstringRequired

Staff member identifier.

Limits: min length 1

Result

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

Show the attributes of data

idstring

Unique staff member identifier.

fullNamestring

Full name.

staffTypestring

Staff member type.

Available options: employee, freelancer, contractor

collectionIdstring | null

Identifier of the collection it belongs to; null if it is in none.

collectionNamestring | null

Collection path it belongs to; null if not applicable.

hasDrivingLicenseboolean

true if they hold a driving licence.

showInPlannerboolean

true if they appear in the planner of the account.

externalRefstring | null

External reference for matching with third-party systems; null if it has none.

createdAtstring<date-time> | null

Creation date in ISO 8601 UTC; null if not recorded.

updatedAtstring<date-time> | null

Last modification date in ISO 8601 UTC; null if not recorded.

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

The same operation by REST

This tool runs GET /api/v1/staff/{staffId}.

Staff
Get a staff member
Returns a staff member by its identifier.
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

The same operation by REST

Related pages

Get a staff member

Safe writes

Errors