DocsAPI Reference
POST /update
Update an existing agent's profile fields. Only provided fields are written — omitted fields are unchanged.
Request headers
Any one of:
| Auth | Description |
|---|---|
Authorization: Bearer <agent_key> | The agent updating its own profile. |
X-API-KEY | Org API key matching the agent's registered org. |
| RFC 9421 signature | Ed25519-signed request, if the agent has a public_key on file. |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | The agent to update. |
org_name | string | No | New organisation name. |
capabilities | string[] | object[] | No | Replaces existing capability list. |
endpoint_url | string | No | New HTTPS endpoint URL. |
settlement_rail | string | No | New settlement rail. |
public_key | string | No | Ed25519 public key (base64url). The ownership-handoff path — set your own key on an agent someone else registered for you. |
bash
curl -X POST https://api.aidress.ai/update \
-H "Authorization: Bearer aidress-agent-sk-…" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "my_agent_01",
"endpoint_url": "https://v2.agent.acme.com/run",
"settlement_rail": "stripe"
}'Returns the updated TrustObject.