Skip to main content

​
Configure Employee

curl -X PATCH https://api.usenaive.ai/v1/employees/emp-abc-123 \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Senior Jordan Kim",
    "title": "Senior Engineer",
    "enabled": true
  }'

{
  "employee": {
    "id": "emp-abc-123",
    "name": "Senior Jordan Kim",
    "title": "Senior Engineer",
    "role": "engineer",
    "enabled": true
  }
}

​
Request Body

FieldTypeDescription
namestringUpdated display name
rolestringUpdated role
titlestringUpdated title
departmentstringUpdated department
enabledbooleanEnable/disable the employee
metadataobjectArbitrary metadata
All fields are optional. Changes take effect for the next task the employee picks up.

​
Fire Employee

curl -X DELETE https://api.usenaive.ai/v1/employees/emp-abc-123 \
  -H "Authorization: Bearer nv_sk_live_..."
200
{
  "success": true,
  "id": "emp-abc-123"
}

​
Behavior

Firing archives the employee (soft delete), returns active tasks to ready status, and deprovisions the Hermes profile. Historical task completions are preserved.