Smart Agent Teams
EndpointsCompanies

Update Company

Update a company's `name`, `mission` or `monthly_budget_cents`. Requires the `owner` or `admin` role; other members get 403 `FORBIDDEN`, and non-members 404 `NOT_FOUND`. Only fields present in the body are changed; `task_prefix` cannot be changed. Money is in integer cents (`0` = no limit). When something changed, records an audit event and publishes `company.updated`.

PATCH
/api/companies/{company_id}

Update a company's name, mission or monthly_budget_cents.

Requires the owner or admin role; other members get 403 FORBIDDEN, and non-members 404 NOT_FOUND. Only fields present in the body are changed; task_prefix cannot be changed. Money is in integer cents (0 = no limit). When something changed, records an audit event and publishes company.updated.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

company_id*Company Id
Formatuuid

Request Body

application/json
  1. body
mission?string|null
monthly_budget_cents?|null
name?|null

Response Body

Successful Response

application/json
  1. response
created_at*|null
id*Id
Formatuuid
mission*string|null
monthly_budget_cents*Monthly Budget Cents
name*Name
role?string|null
task_prefix*Task Prefix
curl -X PATCH "https://example.com/api/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "created_at": "2019-08-24T14:15:22Z",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "mission": "string",  "monthly_budget_cents": 0,  "name": "string",  "role": "string",  "task_prefix": "string"}

Get Company GET

Get one company, including the caller's membership `role`. Members only: a company the caller does not belong to answers 404 `NOT_FOUND`, so company ids cannot be probed.

List Members GET

List the company's members with their name, email and role, in join order. Members only; non-members get 404 `NOT_FOUND`.