*API REST › Objetos › Operaciones*

# Tarea

> La tarea, tal como la devuelve la API.

Una tarea o evento de la agenda, con sus fechas, si dura todo el día, está completada o es recurrente, el personal asignado y el documento con el que se relaciona. Las tareas están acotadas a la suscripción que posee la clave. Las tareas de entrega y devolución que crea una reserva se eliminan cancelando el pedido, no borrándolas aquí.

Esquemas: `TaskDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único de la tarea. |
| `title` | string | Título de la tarea. |
| `description` | string | Descripción o notas de la tarea; null si no tiene. |
| `startDate` | string<date-time> | Fecha y hora de inicio en ISO 8601 con desplazamiento. |
| `endDate` | string<date-time> | Fecha y hora de fin en ISO 8601 con desplazamiento; null si no tiene un fin definido. |
| `isAllDay` | boolean | Si la tarea dura todo el día. |
| `isCompleted` | boolean | Si la tarea está completada. |
| `isRecurring` | boolean | Si la tarea forma parte de una serie recurrente. |
| `recurringGroupId` | string | Identificador del grupo de recurrencia al que pertenece; null si no es recurrente. |
| `recurrencePattern` | object | Patrón de recurrencia de la tarea; null si no es recurrente. |
| `recurrencePattern.frequency` | string | Frecuencia de recurrencia: daily, weekly, monthly o yearly. `daily`, `weekly`, `monthly`, `yearly` |
| `recurrencePattern.interval` | integer | Intervalo entre repeticiones según la frecuencia (p. ej. 2 con weekly = cada dos semanas). |
| `recurrencePattern.endAfterOccurrences` | integer | Número de repeticiones tras las cuales termina la recurrencia; null si no termina por número de ocurrencias. |
| `recurrencePattern.endDate` | string<date-time> | Fecha en que termina la recurrencia, en ISO 8601 con desplazamiento; null si no termina por fecha. |
| `type` | string | Tipo de tarea (identificador del tipo). |
| `assignedStaffIds` | string[] | Identificadores del personal asignado a la tarea. |
| `projectId` | string | Identificador del proyecto vinculado; null si la tarea no está vinculada. |
| `relatedDocumentId` | string | Identificador del documento relacionado; null si no tiene. |
| `relatedDocumentType` | string | Tipo del documento relacionado (contacto, pedido, factura, presupuesto, proyecto, etc.); null si no tiene. |
| `appearance` | object | Aspecto de la tarea en la agenda (color y variante). |
| `appearance.color` | string | Color de la tarea en la agenda (código hexadecimal). |
| `appearance.variant` | string | Variante visual de la tarea: primary, secondary, destructive o default. `primary`, `secondary`, `destructive`, `default` |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 con desplazamiento. |
| `updatedAt` | string<date-time> | Fecha de la última actualización en ISO 8601 con desplazamiento. |

## Ejemplo

*Task · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "title": "Example",
  "description": "string",
  "startDate": "2026-09-01T08:00:00Z",
  "endDate": "2026-09-01T08:00:00Z",
  "isAllDay": true,
  "isCompleted": true,
  "isRecurring": true,
  "recurringGroupId": "string",
  "recurrencePattern": {
    "frequency": "daily",
    "interval": 1,
    "endAfterOccurrences": 1,
    "endDate": "2026-09-01T08:00:00Z"
  },
  "type": "string",
  "assignedStaffIds": [
    "string"
  ],
  "projectId": "string",
  "relatedDocumentId": "string",
  "relatedDocumentType": "string",
  "appearance": {
    "color": "string",
    "variant": "primary"
  },
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/tasks`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/list-tasks) — Listar tareas
- [`GET /api/v1/tasks/{taskId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/get-a-task) — Obtener una tarea

## Lo modifican

- [`POST /api/v1/tasks`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/create-a-task) — Crear una tarea
- [`PATCH /api/v1/tasks/{taskId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/tasks/update-a-task) — Actualizar una tarea

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/task  
Última actualización: 2026-10-25