Tareas

Listar tareas

GET /api/v1/crm/tasks

Parámetros:

Nombre	Tipo	Descripción
cursor	string	Cursor de paginación
limit	int	Items por página (default 25, máx 100)
filter[status]	string	open, completed, cancelled
filter[priority]	string	low, medium, high, urgent
filter[assigned_to]	string	UUID del usuario asignado
filter[entity_kind]	string	contact, account, deal, lead
filter[entity_id]	string	UUID de la entidad asociada
sort	string	due_at, -created_at, priority

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "entity_kind": "contact",
      "entity_id": "uuid",
      "assigned_to": "uuid",
      "title": "Llamar a María García",
      "description": "Seguimiento de propuesta enviada",
      "status": "open",
      "priority": "high",
      "due_at": "2026-04-15T10:00:00Z",
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z",
      "completed_at": null
    }
  ],
  "meta": { "pagination": { "cursor": "eyJ...", "has_next": true, "limit": 25 } }
}

---

Obtener tarea

GET /api/v1/crm/tasks/:id

---

Crear tarea

POST /api/v1/crm/tasks

{
  "entity_kind": "contact",
  "entity_id": "uuid",
  "assigned_to": "uuid",
  "title": "Llamar a María García",
  "description": "Seguimiento de propuesta enviada",
  "priority": "high",
  "due_at": "2026-04-15T10:00:00Z"
}

Respuesta 201: objeto Task completo.

---

Actualizar tarea

PATCH /api/v1/crm/tasks/:id

Mismos campos que crear. Omite los campos que no quieras cambiar.

---

Completar tarea

POST /api/v1/crm/tasks/:id/complete

---

Cancelar tarea

POST /api/v1/crm/tasks/:id/cancel

---

Eliminar tarea

DELETE /api/v1/crm/tasks/:id

Respuesta 204 No Content