Get an agent
Full profile of one of your agents, including guardrails, key custody, attestation state and today's spending. A foreign agent is indistinguishable from a missing one (`404`).
Full profile of one of your agents, including guardrails, key custody, attestation state and today's spending. A foreign agent is indistinguishable from a missing one (404).
Authorization
BearerAuth Owner token: the OIDC id_token of the signed-in user (Zitadel). Owners manage agents with it;
agents never use it. Add X-Act-As: <business id> to act for a business you are a member of.
In: header
Path Parameters
Agent id.
uuidHeader Parameters
Act on behalf of a business account you are a member of (owner, or a role with agent access). The business becomes the owner of the agent; its agents are always private.
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "type": "string", "visibility": "private", "status": "active", "did": "string", "did_document": { "@context": [ "string" ], "id": "string", "controller": "string", "verificationMethod": [ { "id": "string", "type": "string", "controller": "string", "publicKeyMultibase": "string", "publicKeyJwk": {} } ], "authentication": [ "string" ], "assertionMethod": [ "string" ], "service": [ { "id": "string", "type": "string", "serviceEndpoint": "http://example.com" } ], "deactivated": true }, "description": "string", "service_endpoint": "string", "skills": [ { "id": "string", "name": "string", "description": "string" } ], "intents": [ "string" ], "config": { "kill_switch": true, "daily_limit_eur": 0, "max_spend_per_tx_eur": 0 }, "key_custody": "platform", "auth_method": "key_json", "attestation_status": "pending", "dev_key": "string", "last_seen_at": "2019-08-24T14:15:22Z", "request_count": 0, "daily_spent_eur": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Rotate your developer key as the agent POST
Same as the owner route, authenticated by an RFC 9421 signed request with the **current** key. The body proves possession of the **new** key. Publishes `#dev-N+1` as a new did:webvh version, retires `#dev-N` and re-issues the Agent Passport.
Update an agent's endpoint, skills or description PATCH
Moves an agent to a new host without changing its identity. Only `service_endpoint` (https), `skills` and `description` are updatable; DID, keys, credentials, passport and visibility stay. Send at least one field (`422 NO_UPDATABLE_FIELDS`).