Skip to main content
curl -X POST https://api.usenaive.ai/v1/objectives \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Launch email marketing campaign",
    "success_criteria": "3 sequences live, 500 emails sent",
    "drive": "Scale inbound leads by 3x",
    "status": "active"
  }'

{
  "id": "obj-abc-123",
  "title": "Launch email marketing campaign",
  "status": "active",
  "success_criteria": [
    { "criterion": "3 sequences live", "met": false },
    { "criterion": "500 emails sent", "met": false }
  ]
}

​
Request Body

FieldTypeRequiredDescription
titlestringYesObjective title
descriptionstringNoDetailed description
success_criteriastringNoComma-separated or newline-separated criteria (auto-parsed into structured array)
drivestringNoBusiness rationale / driving motivation
drive_modestringNoHow the objective advances: manual or scheduled
cron_schedulestringNoCron expression for scheduled objectives (requires drive_mode: "scheduled")
statusstringNoInitial status (default: active)
metadataobjectNoArbitrary metadata

​
Behavior

The CEO decomposes objectives into tasks on the kanban board during its runs. If drive_mode is scheduled, a pg_cron job fires at the specified interval to advance the objective automatically. Statuses: active → paused | completed | abandoned | archived