v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251238661.6 KB
v1
protected
agents
agents-well-known

Get Agent Well Known Card

Agent-specific well-known discovery endpoint.

Returns the agent card for this specific agent, at /v1/agents/{agent_id}/.well-known/agent-card.json

This allows each agent to have its own well-known endpoint, which is A2A compliant. Later, this can be proxied to subdomains:

  • agent1.domain.com/.well-known/agent-card.json -> /v1/agents/{id}/.well-known/agent-card.json
get/v1/agents/{agent_id}/.well-known/agent-card.json

Path parameters

agent_idstring uuid required

Response

Successful Response

defaultInputModesstring[]
defaultOutputModesstring[]
descriptionstring nullable
documentationUrlstring nullable
namestring required
securityobject[] nullable
securitySchemesobject nullable
versionstring