Skip to main content
curl -X POST https://api.usenaive.ai/v1/tasks \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Write welcome email copy",
    "description": "Draft a 3-paragraph welcome email for new signups",
    "objective_id": "obj-abc-123",
    "assignee": "Jordan Kim",
    "priority": "high"
  }'

{
  "id": "task-def-456",
  "title": "Write welcome email copy",
  "status": "ready",
  "objective_id": "obj-abc-123",
  "assignee": "Jordan Kim",
  "priority": 2,
  "created_at": "2026-01-15T10:00:00Z"
}

​
Request Body

FieldTypeRequiredDescription
titlestringYesTask title
descriptionstringRecommendedDetailed task description — workers use this to understand assignments
objective_idstringNoParent objective ID
assigneestringNoEmployee name (must match exactly, including case)
prioritystringNolow, medium (default), high, or critical

​
Behavior

Tasks are persisted in the central database immediately on creation, regardless of sidecar availability. If an assignee is specified and matches an engineer with a linked app, deployment instructions are automatically appended to the task description. The kanban dispatcher polls every 15 seconds for assigned tasks and auto-spawns worker processes.

​
Errors

404
{
  "error": {
    "code": "employee_not_found",
    "message": "No employee found with name 'Jordan Kim'"
  }
}