Tasks

List tasks

Returns the tasks and schedule events, cursor-paginated.

Tool

filmo_tasks_list

Readtasks:read

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_tasks_list",
    "arguments": {
      "limit": 20
    }
  }
}

{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "title": "Example",
        "description": "<description>",
        "startDate": "2026-09-01T08:00:00Z",
        "endDate": "2026-09-01T08:00:00Z",
        "isAllDay": true,
        "isCompleted": true,
        "isRecurring": true,
        "recurringGroupId": "recu_8f2a1c",
        "recurrencePattern": {
          "frequency": "daily",
          "interval": 1,
          "endAfterOccurrences": 1,
          "endDate": "2026-09-01T08:00:00Z"
        },
        "type": "<type>",
        "assignedStaffIds": [
          "assi_8f2a1c"
        ],
        "projectId": "proj_8f2a1c",
        "relatedDocumentId": "rela_8f2a1c",
        "relatedDocumentType": "<relatedDocumentType>",
        "appearance": {
          "color": "<color>",
          "variant": "primary"
        },
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

Strict per-subscription tenancy.

Arguments

limitintegerdefault:50

Page size (1-500). Defaults to 50.

Limits: min 1, max 500

cursorstring

Opaque cursor of the page to return. Pass the value of pagination.nextCursor from the previous response; treat it as opaque.

Limits: max length 200

sortstring

Sort order: up to 3 comma-separated fields, each with a leading "-" for descending (e.g. "-updatedAt,name"). Sortable fields: createdAt, updatedAt, startDate, endDate, title, isCompleted, type. Defaults to "-createdAt". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with.

Limits: max length 200

fromstring<date-time>

Start of the overlap window (ISO 8601 with offset): returns tasks that overlap [from, to] (a task that starts before and ends within counts).

tostring<date-time>

End of the overlap window (ISO 8601 with offset): returns tasks that overlap [from, to].

assignedStaffIdstring

Filter by assigned staff member (the same identifier that assignedStaffIds exposes in the DTO).

Limits: min length 1, max length 100

assignedStaffIdsstring[]

Filter by assignedStaffId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

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

isCompletedboolean

Filter by completion: "true" only completed tasks, "false" only pending tasks. Omit it to apply no filter.

typestring

Filter by task type: its identifier (system types: default, delivery, return, temporaryStock; custom types: their id) or its name, matched ignoring case and accents. A name that matches no type yields an empty list; one that matches several is rejected with 400.

Limits: min length 1, max length 100

typesstring[]

Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

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

relatedDocumentIdstring

Filter by identifier of the document related to the task.

Limits: min length 1, max length 100

relatedDocumentIdsstring[]

Filter by relatedDocumentId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them.

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

includeTotalbooleandefault:false

Set it to true to include pagination.total, the number of results that match the filters across all pages. Off by default.

dateFiltersobject

Date filters by field. A bare day (YYYY-MM-DD) is read in the business timezone; an ISO 8601 instant with offset is applied as is by gte, lte, gt and lt, while on widens it to the whole business day that contains it. Fields: created, due, updated.

Show child attributes

dateFilters.createdobject

Show child attributes

dateFilters.created.gtestring

From this day or instant, inclusive.

dateFilters.created.ltestring

Up to this day or instant, inclusive.

dateFilters.created.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.created.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.created.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.dueobject

Show child attributes

dateFilters.due.gtestring

From this day or instant, inclusive.

dateFilters.due.ltestring

Up to this day or instant, inclusive.

dateFilters.due.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.due.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.due.onstring

Exactly that day; an instant means the whole business day that contains it.

dateFilters.updatedobject

Show child attributes

dateFilters.updated.gtestring

From this day or instant, inclusive.

dateFilters.updated.ltestring

Up to this day or instant, inclusive.

dateFilters.updated.gtstring

Strictly after; a bare day means after the end of that day.

dateFilters.updated.ltstring

Strictly before; a bare day means before the start of that day.

dateFilters.updated.onstring

Exactly that day; an instant means the whole business day that contains it.

Result

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

Show the attributes of data

idstring

Unique task identifier.

titlestring

Task title.

descriptionstring | null

Task description or notes; null if it has none.

startDatestring<date-time>

Start date and time in ISO 8601 with offset.

endDatestring<date-time> | null

End date and time in ISO 8601 with offset; null if it has no defined end.

isAllDayboolean

Whether the task is all-day.

isCompletedboolean

Whether the task is completed.

isRecurringboolean

Whether the task is part of a recurring series.

recurringGroupIdstring | null

Identifier of the recurrence group it belongs to; null if it is not recurring.

recurrencePatternobject | null

Recurrence pattern of the task; null if it is not recurring.

Show child attributes

recurrencePattern.frequencystring

Recurrence frequency: daily, weekly, monthly or yearly.

Available options: daily, weekly, monthly, yearly

recurrencePattern.intervalinteger

Interval between repetitions according to the frequency (e.g. 2 with weekly = every two weeks).

recurrencePattern.endAfterOccurrencesinteger | null

Number of repetitions after which the recurrence ends; null if it does not end by number of occurrences.

recurrencePattern.endDatestring<date-time> | null

Date on which the recurrence ends, in ISO 8601 with offset; null if it does not end by date.

typestring

Task type (identifier of the type).

assignedStaffIdsstring[]

Identifiers of the staff assigned to the task.

projectIdstring | null

Identifier of the linked project; null if the task is not linked.

relatedDocumentIdstring | null

Identifier of the related document; null if it has none.

relatedDocumentTypestring | null

Type of the related document (contact, order, invoice, quote, project, etc.); null if it has none.

appearanceobject

Appearance of the task in the schedule (color and variant).

Show child attributes

appearance.colorstring

Task color in the schedule (hexadecimal code).

appearance.variantstring

Visual variant of the task: primary, secondary, destructive or default.

Available options: primary, secondary, destructive, default

createdAtstring<date-time>

Creation date in ISO 8601 with offset.

updatedAtstring<date-time>

Last update date in ISO 8601 with offset.

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

Sample prompts

Show the open tasks due this week, grouped by who they are assigned to.

The same operation by REST

This tool runs GET /api/v1/tasks.

Tasks
List tasks
Returns the tasks and schedule events, cursor-paginated.
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

List tasks

Safe writes

Errors