Agent accounts

Agent accounts are the model-provider accounts your agents run on. Add, edit and remove them, and see which nodes each one is set up on.

📄️List accounts

Lists the agent accounts the caller can see, ordered by slug, with each account's provider, status, node and current usage quota readings.

📄️Create account

Creates an agent account for a provider, either a subscription login or a key-based account whose key is checked with the provider before it is stored (422 when refused). Only an Org Owner or Org Admin may create an organization-owned or shared account; anyone else creates a personal key-based account. Returns 201 with the account, or 409 when the slug is already in use.

📄️List nodes for account setup

Lists the nodes the caller can see that an agent account login may be tied to, by name, with whether each supports shared accounts and which agent CLIs it reports.

📄️List agent providers

Lists the agent providers an account can be created for, in catalogue order, with the login kinds the caller's organization allows for each and the default kind.

📄️Delete account

Deletes an agent account's record, leaving any login files on its nodes in place; a key-based account's stored secret is removed with it. Returns 204 with no body. Requires the Org Owner or Org Admin role.

📄️Get account

Returns one agent account with its provider, status, node and usage quota readings. An account the caller cannot see returns 404.

📄️Update account

Updates an agent account's name, description, node, enabled state, shared flag, auto-assign or runner cap, or replaces a key-based account's stored key; omitted fields stay unchanged. The slug, provider and login kind cannot change (422). Requires the Org Owner or Org Admin role.

📄️Deprovision account

Removes an agent account's login files from its node, then deletes the account once the node confirms; a key-based account is deleted directly. Returns 204 with no body; the account is kept on 409 when the node has no recorded home directory, 502 when the node fails, and 503 or 504 when the node cannot be reached. Requires the Org Owner or Org Admin role.

📄️Deprovision account on node

Removes an agent account's login files from one named node; the account itself is deleted only when no other node still holds it. Returns 204 with no body, 409 when the node has no recorded home directory, 502 when the node fails, and 503 or 504 when it cannot be reached. Requires the Org Owner or Org Admin role.