Tareas

Crear, listar y gestionar tareas asociadas a oportunidades, tickets, contactos y cuentas

Endpoints

Metodo	Ruta	Descripcion
`GET`	`/crm/organizations/{organization_id}/tasks`	Listar tareas con filtros
`POST`	`/crm/organizations/{organization_id}/tasks`	Crear una tarea
`GET`	`/crm/organizations/{organization_id}/tasks/:id`	Obtener tarea por ID
`PATCH`	`/crm/organizations/{organization_id}/tasks/:id`	Actualizar una tarea
`PATCH`	`/crm/organizations/{organization_id}/tasks/:id/complete`	Marcar como completada
`DELETE`	`/crm/organizations/{organization_id}/tasks/:id`	Eliminar tarea

Crear tarea

POST /crm/organizations/{organization_id}/tasks

Body

Campo	Tipo	Requerido	Descripcion
`title`	string	Si	Titulo de la tarea
`type`	string	No	`to_do` (default), `call`, `email`, `meeting`, `follow_up`
`priority`	string	No	`low`, `normal` (default), `high`, `urgent`
`due_date`	string	No	Fecha limite ISO 8601
`owner_id`	string	No	UUID del miembro asignado
`deal_id`	string	No	UUID de la oportunidad asociada
`ticket_id`	string	No	UUID del ticket asociado
`contact_id`	string	No	UUID del contacto asociado
`account_id`	string	No	UUID de la cuenta asociada
`notes`	string	No	Notas adicionales

Ejemplo

curl -X POST https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Llamar a cliente para follow-up",
    "type": "call",
    "priority": "high",
    "due_date": "2026-07-20T15:00:00Z",
    "owner_id": "member_uuid",
    "deal_id": "deal_uuid"
  }'

Respuesta

{
  "id": "task_uuid",
  "organization_id": "org_uuid",
  "title": "Llamar a cliente para follow-up",
  "type": "call",
  "status": "pending",
  "priority": "high",
  "due_date": "2026-07-20T15:00:00.000Z",
  "owner_id": "member_uuid",
  "deal_id": "deal_uuid",
  "ticket_id": null,
  "contact_id": null,
  "account_id": null,
  "notes": null,
  "completed_at": null,
  "created_at": "2026-07-15T18:00:00.000Z",
  "updated_at": "2026-07-15T18:00:00.000Z",
  "deal": {
    "id": "deal_uuid",
    "name": "Acme Corp - Enterprise",
    "reference": "MIR-42"
  }
}

Listar tareas

GET /crm/organizations/{organization_id}/tasks

Query params

Parametro	Tipo	Descripcion
`owner_id`	string	Filtrar por miembro asignado
`status`	string	`pending`, `in_progress`, `completed`
`is_completed`	boolean	`true` = completadas, `false` = pendientes
`type`	string	`to_do`, `call`, `email`, `meeting`, `follow_up`
`priority`	string	`low`, `normal`, `high`, `urgent`
`deal_id`	string	Filtrar por oportunidad
`ticket_id`	string	Filtrar por ticket
`contact_id`	string	Filtrar por contacto
`account_id`	string	Filtrar por cuenta
`due_before`	string	Fecha ISO — tareas que vencen antes de
`due_after`	string	Fecha ISO — tareas que vencen despues de
`overdue`	boolean	`true` = solo tareas vencidas (no completadas, due_date < ahora)
`search`	string	Buscar en titulo
`limit`	number	Maximo de resultados (default: 20)
`offset`	number	Paginacion

Ejemplo

# Tareas pendientes del usuario asignado, vencidas
curl "https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks?owner_id=MEMBER_ID&is_completed=false&overdue=true" \
  -H "X-API-Key: <YOUR_API_KEY>"

Obtener tarea

GET /crm/organizations/{organization_id}/tasks/:id

curl https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks/TASK_ID \
  -H "X-API-Key: <YOUR_API_KEY>"

Actualizar tarea

PATCH /crm/organizations/{organization_id}/tasks/:id

Todos los campos son opcionales. Solo se actualizan los campos incluidos en el body.

curl -X PATCH https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks/TASK_ID \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "priority": "urgent",
    "due_date": "2026-07-18T10:00:00Z",
    "notes": "Cliente solicito adelantar la reunion"
  }'

Completar tarea

PATCH /crm/organizations/{organization_id}/tasks/:id/complete

No requiere body. Marca la tarea como completada y registra completed_at.

curl -X PATCH https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks/TASK_ID/complete \
  -H "X-API-Key: <YOUR_API_KEY>"

Eliminar tarea

DELETE /crm/organizations/{organization_id}/tasks/:id

Soft delete — la tarea se marca como eliminada pero no se borra fisicamente.

curl -X DELETE https://api.mirlo.com/v1/crm/organizations/{organization_id}/tasks/TASK_ID \
  -H "X-API-Key: <YOUR_API_KEY>"

Asociaciones

Una tarea puede estar asociada a una o mas entidades simultaneamente:

Oportunidad (deal_id) — tarea relacionada a un deal
Ticket (ticket_id) — tarea de soporte
Contacto (contact_id) — tarea sobre un contacto
Cuenta (account_id) — tarea a nivel empresa

Al listar tareas, las relaciones se incluyen en la respuesta con datos basicos (nombre, referencia).

Las tareas se pueden crear desde la API, desde el detalle de una oportunidad o ticket en el dashboard, o desde la pagina de Tareas.

En esta pagina