Tasks API
List, create, approve, and manage tasks across all agents.
List Tasks
Retrieve tasks for the current site.
GET /api/v1/tasks
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
site_id | string | — | Filter by site |
status | string | — | Filter by status (queued, awaiting_approval, in_progress, completed, failed) |
category | string | — | Filter by category (strategy, research, content, technical, seo) |
page | integer | 1 | Page number |
page_size | integer | 20 | Results per page |
Example Response
{
"items": [
{
"id": "task-uuid",
"title": "Optimize meta description for /products",
"description": "The current meta description is missing. Adding an optimized description will improve CTR.",
"type": "meta_description_optimization",
"status": "awaiting_approval",
"priority": "high",
"site_id": "site-uuid",
"created_at": "2026-02-25T08:00:00Z"
}
],
"total": 15,
"page": 1,
"page_size": 20
}Get Task
Retrieve details for a specific task.
GET /api/v1/tasks/{task_id}
Returns full task details including configuration, deliverables, and execution history.
Approve Task
Approve a task that is awaiting approval.
POST /api/v1/tasks/{task_id}/approve
Example Response
{
"id": "task-uuid",
"status": "queued",
"message": "Task approved and queued for execution"
}Cancel Task
Cancel a pending or queued task.
POST /api/v1/tasks/{task_id}/cancel
Example Response
{
"id": "task-uuid",
"status": "cancelled",
"message": "Task cancelled"
}Task Statuses
| Status | Description |
|---|---|
queued | Waiting to be processed |
awaiting_approval | Needs your review and approval |
in_progress | Agent is actively executing |
completed | Successfully executed |
failed | Execution failed (see error details) |
cancelled | Cancelled by user |