Minctrl Docs
API ReferenceCompanies

Hire an agent onto a project

POST
/companies/{company_id}/projects/{project_id}/roles

Hire an agent onto a project — create the role scoped to it.

Requires a valid bearer token and active membership of company_id (403 otherwise). The project must belong to that company (404 otherwise) so a member cannot seat a role onto another tenant's project.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

company_id*Company Id
project_id*Project 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).

Response Body

application/json

application/json

curl -X POST "https://example.com/companies/string/projects/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