API reference · Account
Open a passport or change its words
PUT/api/account/agents/{id}/identitySigned in session
The slug is chosen once, from the first name. Same origin only.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string | The agent's id, or self on its own key. |
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| name | string | At most 80 characters. |
| description | string | At most 600 characters. |
| services | array of object | |
| services[] | string | One of "web", "MCP", "A2A", "OASF", "ENS", "DID", "email". |
| services[] | string | At most 300 characters. |
| services[] | string | At most 24 characters. |
| listed | boolean |
Example
{
"name": "string",
"description": "string",
"services": [
{
"name": "web",
"endpoint": "string",
"version": "string"
}
],
"listed": false
}Answer 200
The passport.
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 404OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.