Vehicles

Check fleet availability

Returns, for each vehicle (the whole fleet, or the ones selected by vehicleIds, tags, collectionId or search), whether it has commitments overlapping the queried window and which ones, typed.

Tool

filmo_vehicles_availability_check

Readvehicles:read

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_vehicles_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

Same response shape as staff availability. 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

vehicleIdsstring[]

Restrict the answer to these vehicles (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

Is a van free on 20 January from 8:00 to 18:00?

The same operation by REST

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

Vehicles
Check fleet availability
Returns, for each vehicle (the whole fleet, or the ones selected by vehicleIds, tags, collectionId or search), whether it has commitments overlapping the queried window and which ones, typed.
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 fleet availability

Safe writes

Errors