Skip to main content
The Orchestration API provides full lifecycle management of your AI workforce. It includes a CEO agent that interprets high-level prompts and decomposes them into actionable work across a kanban system — objectives, tasks, employees, cron jobs, and persistent memory.

Endpoint Groups

CEO Agent

MethodPathDescription
POST/v1/companies/:companyId/ceo/runStart a new CEO run
GET/v1/companies/:companyId/ceo/statusGet CEO runtime state
POST/v1/companies/:companyId/ceo/messageSteer active session
GET/v1/companies/:companyId/ceo/sessionsList all sessions
GET/v1/companies/:companyId/ceo/runs/:runId/streamStream run output (SSE)
GET/v1/companies/:companyId/ceo/runs/:runIdGet run status
POST/v1/companies/:companyId/ceo/runs/:runId/stopStop a run
POST/v1/companies/:companyId/ceo/team/approveProvision team + tasks

Tasks

MethodPathDescription
GET/v1/tasksList tasks
POST/v1/tasksCreate a task
GET/v1/tasks/:idGet task details
PATCH/v1/tasks/:idUpdate a task
DELETE/v1/tasks/:idDelete a task
POST/v1/tasks/:id/completeMark task done
POST/v1/tasks/:id/blockBlock a task
POST/v1/tasks/:id/unblockUnblock a task
POST/v1/tasks/:id/commentsAdd a comment
POST/v1/tasks/:id/runTrigger task execution
POST/v1/tasks/dispatchAuto-assign pending tasks
GET/v1/tasks/statsBoard statistics

Objectives

MethodPathDescription
GET/v1/objectivesList objectives
POST/v1/objectivesCreate an objective
GET/v1/objectives/:idGet objective details
PATCH/v1/objectives/:idUpdate objective
POST/v1/objectives/:id/pausePause objective
POST/v1/objectives/:id/abandonAbandon objective
DELETE/v1/objectives/:idArchive objective

Employees

MethodPathDescription
GET/v1/employeesList employees
POST/v1/employeesHire an employee
GET/v1/employees/:idGet employee details
PATCH/v1/employees/:idConfigure employee
DELETE/v1/employees/:idFire an employee

Cron Jobs

MethodPathDescription
GET/v1/cronList cron jobs
POST/v1/cronCreate cron job
PATCH/v1/cron/:idUpdate cron job
POST/v1/cron/:id/triggerTrigger manually
POST/v1/cron/:id/pausePause job
DELETE/v1/cron/:idDelete job
GET/v1/cron/:id/executionsExecution history

Memory

MethodPathDescription
GET/v1/memoryList memories
POST/v1/memoryAdd memory
DELETE/v1/memoryRemove memory by text match
DELETE/v1/memory/:idRemove memory by ID

Authentication

All endpoints require either a session cookie or a Bearer API key:
curl https://api.usenaive.ai/v1/tasks \
  -H "Authorization: Bearer nv_sk_live_..."
CEO endpoints use the company-scoped path (/v1/companies/:companyId/ceo/*). All other orchestration endpoints resolve the company from the API key or session automatically.