Skip to main content
curl -X POST https://api.usenaive.ai/v1/employees \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jordan Kim",
    "role": "engineer",
    "title": "Lead Engineer",
    "department": "engineering"
  }'

{
  "employee": {
    "id": "emp-abc-123",
    "name": "Jordan Kim",
    "role": "engineer",
    "title": "Lead Engineer",
    "department": "engineering",
    "status": "idle",
    "enabled": true,
    "created_at": "2026-01-15T10:00:00Z"
  }
}

​
Request Body

FieldTypeRequiredDescription
namestringYesEmployee display name — becomes the kanban assignee identifier
rolestringNoRole: engineer, marketer, writer, sales, designer, researcher, support
titlestringNoJob title
departmentstringNoDepartment
metadataobjectNoArbitrary metadata

​
Behavior

Hiring creates a Hermes profile on disk with config.yaml, SOUL.md, and .env (LLM proxy credentials + Naive CLI access). The employee name is used as the kanban assignee — task assignment uses names, not UUIDs. The dispatcher automatically spawns workers for assigned tasks.