Task types
List task types
Returns the task type catalog: system ones first and then the custom ones of the account.
Request examples
curl https://app.filmo.io/api/v1/task-types \
--header "Authorization: Bearer $FILMO_API_KEY"Generated from the schema
No pagination.
Authorizations
Bearer API key with the scope below. tasks:read
Query parameters
Include archived types: "true" returns them in addition to the active ones; "false" or omission hides them.
Response
Successful response.
Response schema: TaskTypeDto
Envelope: TaskTypeItems. meta. is present only when the operation is deprecated.
Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Show child attributesHide child attributes
Unique identifier of the task type.
Task type name. System types are served in Spanish; custom types carry the name given by the account.
Color associated with the task type (hexadecimal code).
Whether it is a system type (predefined) or a custom type of the account.
Whether the type is archived.
Number of tasks that use the type; null for system types (not computed).
Creation date in ISO 8601 with offset; null for system types.
Last update date in ISO 8601 with offset; null for system types.
Additional information about the response.
Show child attributesHide child attributes
Lifecycle warnings; present only when the operation is deprecated.
Show child attributesHide child attributes
Stable warning code.
Available options: deprecated
For people: what is deprecated, until when, and what to use.
Day (YYYY-MM-DD) the operation stops being served.
operationId of the operation to use instead, or null if there is none.
Where the deprecation is documented (the changelog).
Invalid request (validation_error): malformed query or body. errors[] lists every offending field with its stable code.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Authentication failed (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Headers: X-Request-Id · Content-Language
Not allowed (insufficient_scope: the API key does not have the required scope, named in requiredScope; forbidden: the owner of the key lacks the permission the operation requires). insufficient_scope is answered before the request counts against the rate limit, so it carries no RateLimit-* headers; forbidden does.
Headers: X-Request-Id · Content-Language
Rate limit exceeded (rate_limited): retry after Retry-After seconds; RateLimit-* says which quota ran out.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Internal error (internal_error).
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errors
| Status | Codes | Meaning |
|---|---|---|
| 400 | validation_error | Malformed 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
Related
Related pages
Link to this section: Related pagesOperations
Task type
The task type, as returned by the API.
Was this page helpful?