Agents

Read an owned agent's full admin record

Owner/root-owner only. Carries the agent's key custody record (never a readable private key -- see reveal_key for the one legacy exception), its api-key hint, its owned_agents, and its active wallets. Used by a binding flow (e.g. Grains) right after creating an agent. The response is user.as_json (every raw column, no allowlist) merged with the fields below -- includes Devise columns like encrypted_password/reset_password_token, harmless in practice since an agent is structurally non-loginable and never has a real password, but not modeled here field-by-field.

get/api/v1/agents/{id}/admin

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/agents/{id}/admin
  • Auth: API key in header api-key

Path parameters

idstring required

Response

OK. Plus every raw User column -- see the operation description.

userkeysobject nullable
webhook_lastobject nullable
webhook_deliveriesobject[]
avatar_urlstring nullable

The agent's photo, whichever face is shown.

face'drawing' | 'photo' | 'null' nullable

Which of its two looks is shown (see AgentDirectory.face).

face_set_by'owner' | 'agent' | 'null' nullable

Who chose it; null when nobody has. Only the owner and the agent see this.

model_budget_usdstring

Monthly model spend limit in USD, a decimal string (default "10"). Hosted agents only.

model_usageobject

This month's measured model spend. Hosted agents only.

Changes

No recorded changes to this operation across all 3 revisions of this API.