Task types

List task types

Returns the task type catalog: system ones first and then the custom ones of the account.

Tool

filmo_task_types_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_task_types_list",
    "arguments": {}
  }
}

{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "name": "Example",
        "color": "<color>",
        "isSystem": true,
        "isArchived": true,
        "tasksCount": 1,
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

No pagination.

Arguments

includeArchivedbooleandefault:false

Include archived types: "true" returns them in addition to the active ones; "false" or omission hides them.

Result

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

Show the attributes of data

idstring

Unique identifier of the task type.

namestring

Task type name. System types are served in Spanish; custom types carry the name given by the account.

colorstring

Color associated with the task type (hexadecimal code).

isSystemboolean

Whether it is a system type (predefined) or a custom type of the account.

isArchivedboolean

Whether the type is archived.

tasksCountinteger | null

Number of tasks that use the type; null for system types (not computed).

createdAtstring<date-time> | null

Creation date in ISO 8601 with offset; null for system types.

updatedAtstring<date-time> | null

Last update date in ISO 8601 with offset; null for system types.

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/task-types.

Task types
List task types
Returns the task type catalog: system ones first and then the custom ones of the account.
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

List task types

Safe writes

Errors