Minctrl Docs
API ReferenceCompanies

List agent roles for a company

GET
/companies/{company_id}/roles

List agent roles for a company, optionally filtered by status.

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

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

company_id*Company Id

Query Parameters

status?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/companies/string/roles"
null
Empty
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}