Task types

List task types

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

GET
/api/v1/task-types

Request examples

curl https://app.filmo.io/api/v1/task-types \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "id": "task_type_9f3a2b",
      "name": "Example task type",
      "color": "Example color",
      "isSystem": true,
      "isArchived": true,
      "tasksCount": 1,
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

Generated from the schema

No pagination.

Authorizations

Bearer API key with the scope below. tasks:read

Query parameters

includeArchivedbooleandefault:false

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

Response

application/json

Successful response.

Response schema: TaskTypeDto

Envelope: TaskTypeItems. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset

dataobject[]

Show child attributes
data.idstring

Unique identifier of the task type.

data.namestring

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

data.colorstring

Color associated with the task type (hexadecimal code).

data.isSystemboolean

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

data.isArchivedboolean

Whether the type is archived.

data.tasksCountinteger | null

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

data.createdAtstring<date-time> | null

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

data.updatedAtstring<date-time> | null

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

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
400validation_errorMalformed query or body. errors[] lists every offending field with its stable code.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy

  • Operations

    Task type

    The task type, as returned by the API.