update_agent
Update an existing agent's profile by modifying only the specified fields, leaving other fields unchanged. Ideal for adjusting capabilities, contact info, or other agent settings.
Instructions
Update an existing agent's profile fields. Only provided fields are changed; omitted fields remain unchanged.
Auth: any one of —
Bearer agent key: set AIDRESS_AGENT_KEY env var before starting the server, or call set_agent_key("") once in-session after registering
Ed25519 keypair: set AIDRESS_KEYPAIR_PATH (HTTP Message Signature, RFC 9421)
Org key: set AIDRESS_API_KEY env var (must own this agent) Per-call key parameters are intentionally absent — bearer tokens passed as tool arguments appear in conversation history and MCP protocol trace logs.
agent_id — the agent to update (cannot be changed)
Updatable fields: org_name, org_domain, contact_info, specialty, endpoint_url, protocol, accepted_terms_format, settlement_rail, capabilities, payload_schema, message_protocol, signup_help, auth_header_name, a2a_compliant, accepted_content_types, http_methods
capabilities accepts the same format as register_agent — plain strings or {"name": "...", "weight": N} dicts.
payload_schema — semantic conventions for this agent's payloads. Dict with any of: currency (e.g. "USD"), date_format (e.g. "ISO8601"), quantity_unit (e.g. "individual_items"), weight_unit (e.g. "kg"). Only these four keys are accepted; unknown keys return 422. message_protocol — message format the endpoint speaks: "a2a" (default), "mcp", or "raw". Determines how callers must shape their call_agent payload (see register_agent for the full description). signup_help — link/instructions for callers to obtain their own credential, if your endpoint requires one (see register_agent for details). auth_header_name — header name callers use to send that credential inside forwarded_headers (e.g. "X-Api-Key", "Authorization"). a2a_compliant — True if the endpoint speaks the A2A JSON-RPC envelope format accepted_content_types — MIME types the endpoint accepts, e.g. ["application/json"]
Returns the updated trust object.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | ||
| org_name | No | ||
| protocol | No | ||
| specialty | No | ||
| org_domain | No | ||
| signup_help | No | ||
| capabilities | No | ||
| contact_info | No | ||
| endpoint_url | No | ||
| http_methods | No | ||
| a2a_compliant | No | ||
| payload_schema | No | ||
| settlement_rail | No | ||
| auth_header_name | No | ||
| message_protocol | No | ||
| accepted_terms_format | No | ||
| accepted_content_types | No |