Skip to main content

Tasks

Generic task management for events and leads.

Event tasks​

Base path:

/api/v1/{workspace_id}/events/{event_id}/tasks/

Lead tasks​

Base path:

/api/v1/{workspace_id}/leads/{lead_id}/tasks/

Both mounts expose identical routes.

Task groups​

GET    …/tasks/groups/
POST   …/tasks/groups/
GET    …/tasks/groups/{group_id}/
PUT    …/tasks/groups/{group_id}/
PATCH  …/tasks/groups/{group_id}/
DELETE …/tasks/groups/{group_id}/

Tasks​

GET    …/tasks/
POST   …/tasks/
GET    …/tasks/{task_id}/
PUT    …/tasks/{task_id}/
PATCH  …/tasks/{task_id}/
DELETE …/tasks/{task_id}/

Create task — request body​

{
  "title": "Confirm booth setup",
  "description": "Verify power and Wi-Fi before doors open",
  "status": "todo",
  "priority": "high",
  "due_date": "2026-09-14",
  "assigned_to": "660e8400-e29b-41d4-a716-446655440001",
  "group": "bb0e8400-e29b-41d4-a716-446655440006"
}

Create task — response (201 Created)​

{
  "id": "cc0e8400-e29b-41d4-a716-446655440007",
  "title": "Confirm booth setup",
  "status": "todo",
  "priority": "high",
  "due_date": "2026-09-14",
  "assigned_to": "660e8400-e29b-41d4-a716-446655440001",
  "created_at": "2026-06-20T13:00:00Z"
}

Bulk operations​

POST  …/tasks/bulk_delete/
PATCH …/tasks/bulk_update/

Bulk update example​

PATCH /api/v1/{workspace_id}/events/{event_id}/tasks/bulk_update/
Content-Type: application/json

{
  "task_ids": ["uuid-1", "uuid-2"],
  "status": "done"
}

Webhooks​

Task assignment and status changes emit webhook events:

  • task.assigned
  • task.status_changed

See Webhooks.