Listar tareas

GEThttps://api.bydomu.com/v1/tasks

This reference is generated from the API’s code, so descriptions are in Spanish. Names, parameters and examples are the same in every language.

Tareas de toda la organización con filtros y paginación por página o por cursor (pageSize máximo 500). Por defecto solo las no archivadas. status, type y priority aceptan varios valores separados por comas.

Permission

tasks:read

Keys

Secret only (server-side)

Headers

X-API-Keystringrequired

Your secret key.

Query parameters

pageinteger

Página, desde 1 · default=1 · ≥ 1

pageSizeinteger

Tareas por página (máximo 500) · default=20 · 1–500

cursorstring

Paginación por cursor: el meta.nextCursor de la respuesta anterior

includeTotalboolean | string

false para no contar el total (más rápido)

sortBystring

Campo de orden · default="createdAt"

sortOrderstring

Dirección del orden ascdesc · default="desc"

searchstring

Texto en el título, o prefijo del ID

assigneeIdstring

Responsable

createdByIdstring

Quién la creó

statusstring[]

Estados, separados por comas. OVERDUE = abiertas con fecha vencida · nullable

typestring[]

Tipos, separados por comas · nullable

prioritystring[]

Prioridades, separadas por comas · nullable

dateFromstring

Vencen desde esta fecha (ISO 8601) · nullable

dateTostring

Vencen hasta esta fecha (ISO 8601) · nullable

dueDateModestring

Solo con fecha (WITH_DATE) o sin fecha (WITHOUT_DATE) WITH_DATEWITHOUT_DATE

dueSoonboolean

Abiertas que vencen en las próximas 48 h. Cualquier valor no vacío (incluso false) cuenta como verdadero · nullable

archivedboolean

SOLO las archivadas. Cualquier valor no vacío (incluso false) cuenta como verdadero: para las vivas, omítelo · nullable

Responses

200Página de tareas

400Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.

401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.

403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.

429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.

500INTERNAL_ERROR · Error interno del servidor.

{ "data": [ { "id": "clx1tsk001", "title": "Llamar a María para confirmar la visita", "description": "Confirmar el jueves a las 10.", "type": "CALL", "status": "PENDING", "priority": "LOW", "dueDate": "2026-10-01T15:00:00.000Z", "completedAt": "2026-10-01T14:40:00.000Z", "archivedAt": "2026-10-15T00:00:00.000Z", "attachments": [], "dealId": "clx1deal001", "contactId": "clx1con001", "assigneeId": "clx1usr001", "createdById": "clx1usr002", "createdAt": "2026-09-25T10:00:00.000Z", "updatedAt": "2026-09-25T10:00:00.000Z", "assignee": { "id": "clx1usr001", "firstName": "Carlos", "lastName": "Rodríguez", "avatarUrl": "https://cdn.bydomu.com/avatars/carlos.jpg" }, "createdBy": { "id": "clx1usr001", "firstName": "Carlos", "lastName": "Rodríguez" }, "deal": { "id": "clx1deal001", "title": "Venta Apto Chapinero", "contact": { "id": "clx1con001", "firstName": "María", "lastName": "González" } }, "contact": { "id": "clx1con001", "firstName": "María", "lastName": "González" }, …