Smart Agent Teams
EndpointsCompanies

List Companies

List the companies the caller belongs to, oldest first. Each item carries the caller's membership `role` (`owner`, `admin` or `member`). Companies the caller is not a member of are never returned.

GET
/api/companies

List the companies the caller belongs to, oldest first.

Each item carries the caller's membership role (owner, admin or member). Companies the caller is not a member of are never returned.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Response Body

Successful Response

application/json
  1. response
[index: integer]?
curl -X GET "https://example.com/api/companies"
[  {    "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"  }]

Revoke My Api Key DELETE

Revoke one of the caller's API keys; it stops authenticating immediately. Requires a signed-in session token, not an API key (403 `SESSION_REQUIRED`). Answers 404 `NOT_FOUND` if the key does not exist, is already revoked or belongs to another user.

Create Company POST

Create a company and make the caller its `owner`. `task_prefix` (default `SAT`, 1-8 characters, uppercase letters and digits, starting with a letter) forms task keys such as `SAT-12` and cannot be changed later. `monthly_budget_cents` is in integer cents; `0` means no limit. Records a `created` audit event.