Saltar al contenido
Empieza gratis

Referencia · tasks

Obtener tarea

GET/tasks/{id}

Requiere el scope tasks:read.

Las mismas tareas que ve el usuario en la app: las propias y las visibles de los proyectos compartidos donde es propietario/a o miembro activo. Una tarea sin acceso (incluida una privada de otra persona), inexistente o con id malformado responde el mismo 404 (no se filtra existencia). Hasta 2026-09 este endpoint solo servía tareas propias; las compartidas daban 404.

Parámetros de ruta

idstringobligatorio

Id de la tarea.

Respuestas

200

La tarea.

dataTaskobligatorio

Tarea. Todos los campos están siempre presentes; los sin valor van como null (nunca se omiten). Timestamps en epoch milisegundos UTC.

Campos de Task
idstringobligatorio
titlestringobligatorio
statusTaskStatusobligatorio

Valores: backlogin_progressdone

priorityTaskPriorityobligatorio

Valores: highmediumlow

progressnumber | nullobligatorio

Rango: 0–100

notesstring | nullobligatorio
projectIdstring | nullobligatorio
deadlinenumber | nullobligatorio

Fin del intervalo o fecha exacta (epoch ms).

deadlineStartnumber | nullobligatorio

Inicio del intervalo (epoch ms).

deadlineTypeDeadlineType | nullobligatorio

Granularidad del deadline (deadline = fin o fecha exacta, deadlineStart = inicio opcional).

Valores: exactdateweekmonthcustom

recurrenceRecurrence | nullobligatorio

Solo la lleva la ocurrencia pendiente de una serie; las completadas van con null.

Campos de Recurrence
frequencyRecurrenceFrequencyobligatorio

Valores: dailyweeklymonthlyyearly

intervalnumber

Rango: 1–99

dayOfWeeknumber

0 = domingo … 6 = sábado.

Rango: 0–6

dayOfMonthnumber

-1 = último día del mes; si no, 1..31.

Rango: -1–31

seriesIdstring | nullobligatorio

Serie recurrente a la que pertenece (pendiente o completada); null si nunca se repitió.

createdAtnumberobligatorio
updatedAtnumberobligatorio
completedAtnumber | nullobligatorio
createdByPersonobligatorio

Cuenta de SecretarIA. Sin correo a propósito.

Campos de Person
idstringobligatorio
namestring | nullobligatorio

Nombre de pila; null si la cuenta ya no existe.

assigneePerson | nullobligatorio

Persona asignada en un proyecto compartido; null = sin asignar.

Campos de Person
idstringobligatorio
namestring | nullobligatorio

Nombre de pila; null si la cuenta ya no existe.

401

Key ausente, malformada, inexistente, revocada, expirada o API deshabilitada (invalid_api_key, indistinguibles a propósito).

Códigos: invalid_api_key

403

Scope insuficiente (insufficient_scope), recurso sin acceso (forbidden) o sincronización de calendario de una tarea que creó otra persona (calendar_creator_only).

Códigos: insufficient_scopeforbiddencalendar_creator_only

404

Recurso inexistente, de otro usuario o id malformado (not_found, indistinguibles a propósito).

Códigos: not_found

429

Límite superado (rate_limited) — 60 req/min (ráfagas de 20) y 5.000 req/día por key. Reintentar tras Retry-After.

Códigos: rate_limited

Cabecera Retry-After: Segundos (enteros) a esperar antes de reintentar.

500

Error interno (internal_error). Cuerpo opaco a propósito; reintentar con backoff.

Códigos: internal_error

Documentación