Skip to main content
curl -X POST https://api.usenaive.ai/v1/companies/:companyId/ceo/team/approve \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "team": [
      { "name": "Jordan Kim", "title": "Lead Engineer", "template": "engineer", "skills": ["typescript", "react"] },
      { "name": "Alex Rivera", "title": "Content Marketer", "template": "writer", "skills": ["seo", "copywriting"] }
    ],
    "tasks": [
      { "title": "Build landing page", "description": "Create responsive landing page with hero section", "assignee": "Jordan Kim", "priority": "high" },
      { "title": "Write blog posts", "description": "Draft 3 launch posts", "assignee": "Alex Rivera", "priority": "medium" }
    ],
    "objective_id": "obj-abc-123"
  }'
{
  "status": "team_provisioned",
  "agents_created": ["Jordan Kim", "Alex Rivera"],
  "apps_created": [],
  "tasks_created": 2,
  "count": {
    "agents": 2,
    "tasks": 2,
    "apps": 0
  }
}

Request Body

FieldTypeRequiredDescription
teamarrayYesTeam member definitions (see below)
tasksarrayNoTasks to create and assign
appsarrayNoApps to create during provisioning
objective_idstringNoParent objective to link tasks to

Team Member Fields

FieldTypeRequiredDescription
namestringYesEmployee display name
titlestringYesJob title
templatestringNoRole template: engineer, writer, hunter, legal
skillsarrayNoSkill tags
contextstringNoAdditional context for the agent profile
personastringNoPersona description
rolestringNoFunctional role
departmentstringNoDepartment assignment

Task Fields

FieldTypeRequiredDescription
titlestringYesTask title
descriptionstringYesTask description
assigneestringYesEmployee name (must match a team member)
prioritystringNolow, medium, high, critical
phaseintegerNoExecution phase (1 or 2)

Behavior

This endpoint provisions the full team in one atomic operation: creates employee Hermes profiles, assigns tasks, and optionally creates apps. Engineers assigned to apps automatically receive deployment instructions injected into their task descriptions.