*REST API › Objects › Operations*

# Task type

> The task type, as returned by the API.

An entry of the catalog of task types, system ones and custom ones, with its color and how many tasks use it. It is read-only. Task types are bounded to the subscription that owns the key.

Schemas: `TaskTypeDto`

## Attributes

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Unique identifier of the task type. |
| `name` | string | Task type name. System types are served in Spanish; custom types carry the name given by the account. |
| `color` | string | Color associated with the task type (hexadecimal code). |
| `isSystem` | boolean | Whether it is a system type (predefined) or a custom type of the account. |
| `isArchived` | boolean | Whether the type is archived. |
| `tasksCount` | integer | Number of tasks that use the type; null for system types (not computed). |
| `createdAt` | string<date-time> | Creation date in ISO 8601 with offset; null for system types. |
| `updatedAt` | string<date-time> | Last update date in ISO 8601 with offset; null for system types. |

## Example

*Task type · Generated from the schema*

```json
{
  "id": "id_8f2a1c",
  "name": "Example",
  "color": "string",
  "isSystem": true,
  "isArchived": true,
  "tasksCount": 1,
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Returned by

- [`GET /api/v1/task-types`](https://docs.filmo.io/rest-api/endpoint-reference/task-types/list-task-types) — List task types

## Modified by

No operation.

---

Canonical URL: https://docs.filmo.io/rest-api/objects/task-type  
Last updated: 2026-10-25