Skip to main content
curl -X POST https://api.usenaive.ai/v1/tasks/task-def-456/run \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "task": {
    "id": "task-def-456",
    "title": "Build landing page",
    "status": "in_progress",
    "assignee": "Jordan Kim"
  },
  "run_triggered": true,
  "dispatch_result": {
    "worker_pid": 54321,
    "started_at": "2026-01-15T10:05:00Z"
  }
}

​
Path Parameters

ParamTypeDescription
idstringTask ID (UUID or Hermes ID)

​
Behavior

Triggers the kanban dispatcher to immediately spawn a worker for the specified task. The task must already have an assignee and not be in done or blocked status. Use this when you want to start work on a task without waiting for the 15-second auto-dispatch cycle.

​
Errors

400
{
  "error": {
    "code": "task_not_assignable",
    "message": "Task must have an assignee and be in ready or in_progress status"
  }
}