Minctrl Docs
API ReferenceCompanies

Create a company

POST
/companies

Create a company with auto-created charter and company-level budget.

Requires a valid bearer token. The caller becomes the owner and is backfilled an owner membership so RBAC checks pass immediately.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body to create a company (auto-creates charter + budget).

Response Body

application/json

application/json

curl -X POST "https://example.com/companies" \  -H "Content-Type: application/json" \  -d '{    "mission": "Ship governed AI operations.",    "name": "Acme AI",    "north_star_metric": "Weekly active governed processes",    "slug": "acme-ai"  }'
null
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}