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 NodeLink account; anyone else creates a personal key-based account. Returns 201 with the account, or 409 when the slug is already in use.
Import account
Creates an agent account from an exported file under a new slug with auto-assign off, checking a key-based account's key with the provider before storing it. A wrong `passphrase` or an edited file returns 422 and creates nothing. A subscription account is created with `needs_login` true until it logs in on a node; every import returns 201.
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.
Get account provisioning
Lists the in-progress and most recent add-account and re-login runs for agent accounts, with each run's node, step, status and error. Requires permission to view system settings; returns an empty list unless the caller may also view agent accounts, and shows only accounts granted to the caller on nodes they can see.
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, runner cap or owner (personal or organization, and a personal account's member), 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.
Export account
Exports an agent account as a file another Jaah console can import: a key-based account's key sealed under the `passphrase` (at least 12 characters) and recorded as a credential read, a subscription account as its record only. Returns 409 when the stored key cannot be opened. 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.
Remove account
Deletes an agent account: takes it out of rotation, stops the tasks running on it (each keeps its worktree and relaunches on another account), deletes it, and removes its login files from its shared folder and from every node that holds them, in the background after the answer; an offline node removes them when it next connects. A key-based account is deleted directly, with its stored secret. Returns 204 with no body, and requires the Org Owner or Org Admin role.
Get portfolio resources
Returns agent accounts with their quota, busy and idle sessions, runners and worktrees, plus overall session and runner totals, for nodes the caller can see. Filters by node; accounts the caller may not view are hidden and counted. Requires permission to view system settings.