Hire an agent

Hire an agent — create role + budget.

Requires a valid bearer token. Owner-scoped: only the company owner may hire (403 otherwise); a missing company returns 404.

Authorization

HTTPBearer

AuthorizationBearer <token>

In: header

Path Parameters

company_id*Company Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body to hire an agent — create its role (and budget).

agent_class*Agent Class

Agent implementation class to seat in this role.

Length1 <= length <= 100

title*Title

Human-readable role title.

Length1 <= length <= 200

department_id?|

Optional department the role belongs to.

reports_to?|

Optional id of the role this one reports to.

preferred_model?Preferred Model

Preferred LLM model for this role.

Lengthlength <= 200

Default"anthropic/claude-sonnet-4"

kpis?array<>

KPI targets the agent is measured against.

monthly_budget_usd?Monthly Budget Usd

Monthly spend cap for the role, in USD.

Range0 <= value

Default50

Response Body

`application/json`

curl -X POST "https://example.com/companies/string/roles" \  -H "Content-Type: application/json" \  -d '{    "agent_class": "compliance_reviewer",    "kpis": [      {        "metric": "approval_accuracy",        "target": 0.95,        "weight": 1      }    ],    "monthly_budget_usd": 50,    "preferred_model": "anthropic/claude-sonnet-4",    "title": "Compliance Reviewer"  }'

null

Empty

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}

Hire an agent

Authorization

Path Parameters

Request Body

Response Body

201application/json

401

403

404

422application/json

`application/json`

`application/json`