Recursos principales

Tareas

CRUD de tareas vinculadas a expedientes y usuarios

curl "https://app.getplea.com/api/tasks?status=pending&limit=20" \
  -H "Authorization: Bearer TOKEN" \
  -H "x-organization-id: ORG_ID"

[
  {
    "id": "task-uuid-1",
    "title": "Preparar escrito de demanda",
    "description": "Redactar y revisar el escrito de demanda para presentar ante el juzgado",
    "status": "pending",
    "priority": "high",
    "dueDate": "2026-03-15T23:59:59Z",
    "caseId": "case-uuid-1",
    "caseNumber": "2026/0042",
    "assignedTo": "user-uuid-1",
    "assignedToName": "Ana López Fernández",
    "createdAt": "2026-03-01T09:00:00Z"
  },
  {
    "id": "task-uuid-2",
    "title": "Solicitar documentación al cliente",
    "status": "pending",
    "priority": "medium",
    "dueDate": "2026-03-10T23:59:59Z",
    "caseId": "case-uuid-1",
    "caseNumber": "2026/0042",
    "assignedTo": "user-uuid-2",
    "assignedToName": "Pedro Martín Sánchez",
    "createdAt": "2026-03-02T11:30:00Z"
  }
]

curl https://app.getplea.com/api/tasks/task-uuid-1 \
  -H "Authorization: Bearer TOKEN" \
  -H "x-organization-id: ORG_ID"

{
  "id": "task-uuid-1",
  "title": "Preparar escrito de demanda",
  "description": "Redactar y revisar el escrito de demanda para presentar ante el juzgado",
  "status": "pending",
  "priority": "high",
  "dueDate": "2026-03-15T23:59:59Z",
  "caseId": "case-uuid-1",
  "assignedTo": "user-uuid-1",
  "createdAt": "2026-03-01T09:00:00Z",
  "updatedAt": "2026-03-01T09:00:00Z"
}

curl -X POST https://app.getplea.com/api/tasks \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-organization-id: ORG_ID" \
  -d '{
    "title": "Revisar contrato de arrendamiento",
    "description": "Revisar cláusulas 5 y 7 del contrato actualizado",
    "priority": "high",
    "dueDate": "2026-03-20T23:59:59Z",
    "caseId": "case-uuid-1",
    "assignedTo": "user-uuid-1"
  }'

const task = await fetch('/api/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TOKEN',
    'Content-Type': 'application/json',
    'x-organization-id': 'ORG_ID'
  },
  body: JSON.stringify({
    title: 'Revisar contrato de arrendamiento',
    description: 'Revisar cláusulas 5 y 7 del contrato actualizado',
    priority: 'high',
    dueDate: '2026-03-20T23:59:59Z',
    caseId: 'case-uuid-1',
    assignedTo: 'user-uuid-1'
  })
}).then(r => r.json());

{
  "id": "task-uuid-new",
  "title": "Revisar contrato de arrendamiento",
  "description": "Revisar cláusulas 5 y 7 del contrato actualizado",
  "status": "pending",
  "priority": "high",
  "dueDate": "2026-03-20T23:59:59Z",
  "caseId": "case-uuid-1",
  "assignedTo": "user-uuid-1",
  "createdAt": "2026-03-07T12:00:00Z"
}

curl -X PATCH https://app.getplea.com/api/tasks/task-uuid-1 \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -H "x-organization-id: ORG_ID" \
  -d '{"status": "completed"}'

await fetch('/api/tasks/task-uuid-1', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer TOKEN',
    'Content-Type': 'application/json',
    'x-organization-id': 'ORG_ID'
  },
  body: JSON.stringify({ status: 'completed' })
});

{
  "id": "task-uuid-1",
  "title": "Preparar escrito de demanda",
  "status": "completed",
  "updatedAt": "2026-03-07T15:00:00Z"
}

curl -X DELETE https://app.getplea.com/api/tasks/task-uuid-1 \
  -H "Authorization: Bearer TOKEN" \
  -H "x-organization-id: ORG_ID"

{
  "message": "Tarea eliminada correctamente"
}

Endpoints para crear, listar, actualizar y eliminar tareas. Las tareas pueden estar vinculadas a un expediente y asignadas a un miembro del equipo.

GET /api/tasks

Lista las tareas con filtros opcionales.

query

caseIdstring

Filtrar por UUID del expediente.

query

statusstring

Filtrar por estado: pending, in_progress, completed.

query

assignedTostring

Filtrar por UUID del usuario asignado.

query

limitnumber

Máximo de resultados. Default: 50.

query

offsetnumber

Desplazamiento para paginación.

GET /api/tasks/:id

Obtiene el detalle de una tarea.

path

idstring

Required

UUID de la tarea.

POST /api/tasks

Crea una nueva tarea.

Título de la tarea.

Descripción detallada.

body

statusstring

Estado inicial: pending, in_progress. Default: pending.

body

prioritystring

Prioridad: low, medium, high, urgent.

body

dueDatestring

Fecha de vencimiento (ISO 8601).

body

caseIdstring

UUID del expediente asociado.

body

assignedTostring

UUID del usuario asignado.

PATCH /api/tasks/:id

Actualiza una tarea existente.

path

idstring

Required

UUID de la tarea.

DELETE /api/tasks/:id

Elimina una tarea.

path

idstring

Required

UUID de la tarea.

Was this page helpful?

Built with Documentation.AI

Last updated today