Skip to main content
curl -X POST https://api.usenaive.ai/v1/tasks/task-def-456/complete \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "Landing page deployed at https://example-app.vercel.app",
    "metadata": { "url": "https://example-app.vercel.app", "pages": 3 }
  }'
{
  "id": "task-def-456",
  "title": "Build landing page",
  "status": "done",
  "completed_at": "2026-01-15T12:00:00Z",
  "summary": "Landing page deployed at https://example-app.vercel.app"
}

Path Parameters

ParamTypeDescription
idstringTask ID (UUID or Hermes ID)

Request Body

FieldTypeRequiredDescription
summarystringNoCompletion summary
metadataobjectNoStructured metadata to attach to the completed task

Behavior

Sets the task status to done and records the completion timestamp. The summary and metadata are preserved for audit and CEO reporting purposes.