Schedule

Get the schedule for a range

Returns the consolidated schedule of a window: projects, orders, tasks, internal services and order services.

Tool

filmo_schedule_get

Readschedule:read

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

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

{
  "structuredContent": {
    "data": {
      "projects": [
        {
          "id": "id_8f2a1c",
          "name": "Example",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "status": "<status>"
        }
      ],
      "orders": [
        {
          "id": "id_8f2a1c",
          "orderNumber": "<orderNumber>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "status": "<status>",
          "contactName": "Example",
          "projectName": "Example"
        }
      ],
      "tasks": [
        {
          "id": "id_8f2a1c",
          "title": "Example",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "isAllDay": true,
          "isCompleted": true,
          "type": "<type>",
          "projectId": "proj_8f2a1c",
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ]
        }
      ],
      "internalServices": [
        {
          "id": "id_8f2a1c",
          "title": "Example",
          "serviceType": "<serviceType>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "projectName": "Example",
          "qty": 1,
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ],
          "assignedVehicleIds": [
            "assi_8f2a1c"
          ]
        }
      ],
      "orderServices": [
        {
          "orderId": "orde_8f2a1c",
          "orderNumber": "<orderNumber>",
          "serviceName": "Example",
          "serviceType": "<serviceType>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "contactName": "Example",
          "projectName": "Example",
          "qty": 1,
          "assignedCount": 1,
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ]
        }
      ]
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

It does not paginate: it is bounded by dates, which is what a calendar asks for, but each layer is capped and the response does not say when it was cut: at most 200 projects, 200 orders and 500 tasks, ordered by start date, so a layer that returns exactly its cap may be truncated (use a shorter window). Only active records appear: projects in draft, budgeted, confirmed or in_progress, and orders in draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned or checked_in_partially; a checked_in, cancelled or archived order is not returned. It is therefore not a complete snapshot: do not delete a record only because it is missing. Assignees come out by identifier and name; their contact details do not.

Arguments

startDatestring<date-time>Required

Window start, in ISO 8601 with offset.

endDatestring<date-time>Required

Window end, in ISO 8601 with offset.

layersstring[]

Which layers to fetch: projects, orders, tasks, internal_services or order_services. By default, everything. Repeat the parameter or separate the values with commas for several.

Available options: projects, orders, tasks, internal_services, order_services

Limits: min 1 items, max 50 items

projectStatusstring[]

Filter projects by status.

Limits: min 1 items, max 50 items

orderStatusstring[]

Filter orders by status.

Limits: min 1 items, max 50 items

assignedToStaffIdsstring[]

Keep only what is assigned to these staff members.

Limits: min 1 items, max 200 items

Result

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

Show the attributes of data

projectsobject[]

Projects that fall within the window.

Show child attributes

projects.idstring

projects.namestring

projects.startDatestring<date-time>

projects.endDatestring<date-time>

projects.statusstring

ordersobject[]

Orders that fall within the window.

Show child attributes

orders.idstring

orders.orderNumberstring

orders.startDatestring<date-time>

orders.endDatestring<date-time>

orders.statusstring

orders.contactNamestring | null

orders.projectNamestring | null

tasksobject[]

Schedule tasks. Without the contact data of whoever they are assigned to.

Show child attributes

tasks.idstring

tasks.titlestring

tasks.startDatestring<date-time> | null

tasks.endDatestring<date-time> | null

tasks.isAllDayboolean

tasks.isCompletedboolean

tasks.typestring | null

tasks.projectIdstring | null

tasks.assignedStaffobject[]

Show child attributes

tasks.assignedStaff.idstring

Staff member identifier.

tasks.assignedStaff.fullNamestring

Name shown in the schedule.

internalServicesobject[]

Assignments not attached to an order.

Show child attributes

internalServices.idstring

internalServices.titlestring

internalServices.serviceTypestring

internalServices.startDatestring<date-time>

internalServices.endDatestring<date-time>

internalServices.projectNamestring | null

internalServices.qtynumber

internalServices.assignedStaffobject[]

Show child attributes

internalServices.assignedStaff.idstring

Staff member identifier.

internalServices.assignedStaff.fullNamestring

Name shown in the schedule.

internalServices.assignedVehicleIdsstring[]

orderServicesobject[]

Staff and fleet services attached to an order.

Show child attributes

orderServices.orderIdstring

orderServices.orderNumberstring

orderServices.serviceNamestring

orderServices.serviceTypestring

orderServices.startDatestring<date-time>

orderServices.endDatestring<date-time>

orderServices.contactNamestring | null

orderServices.projectNamestring | null

orderServices.qtynumber

orderServices.assignedCountnumber

orderServices.assignedStaffobject[]

Show child attributes

orderServices.assignedStaff.idstring

Staff member identifier.

orderServices.assignedStaff.fullNamestring

Name shown in the schedule.

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

Sample prompts

What is on the calendar between Monday and Friday?

The same operation by REST

This tool runs GET /api/v1/schedule.

Schedule
Get the schedule for a range
Returns the consolidated schedule of a window: projects, orders, tasks, internal services and order services.
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

Get the schedule for a range

Safe writes

Errors