Get a Published Agent by ID — GET /v1/agents/:agent_id

Retrieve the full record of a published agent by its agent_id, including the A2A agent card, deployment config, and review profile.

Fetches the complete record for a single published agent, including its A2A agent card, deployment endpoint, and review metadata.

Request

curl http://your-node:8042/v1/agents/stripe-agent

Path parameters

agent_id · string · required

The unique identifier of the published agent to retrieve (e.g. "stripe-agent").

Response

Returns a PublishedAgentRecord on success.

agent_id · string

Unique identifier for the agent.

provider_id · string

Identifier of the provider that submitted this agent.

version · string

Semantic version string (e.g. "1.2.0").

status · string

One of "approved", "suspended", or "revoked".

agent_card · object

Full A2A agent card describing the agent’s name, description, URL, skills, and security schemes.

deployment · object

Deployment configuration.

Show deployment fields

runtime · string

Execution runtime identifier (e.g. "remote_http").

endpoint · object

Show endpoint fields

url · string

The A2A endpoint URL the gateway will proxy requests to.

protocol_binding · string

Protocol binding (e.g. "JSONRPC").

protocol_version · string

Protocol version string (e.g. "1.0").

interaction_protocol · string

Interaction protocol. Currently always "google_a2a".

review · AgentReviewProfile

Review metadata.

Show review fields

risk_level · string

One of "low", "medium", or "high".

data_classes · string[]

Categories of data the agent handles (e.g. ["financial"]).

destructive_actions · string[]

List of destructive action identifiers the agent can perform.

human_approval_required · boolean

Whether invocations require human approval before execution.

allowed_regions · string[]

ISO country codes the agent is permitted to operate in. An empty array means no regional restriction.

cost_per_call_units · integer

Cost in abstract units per invocation. Omitted if not set.

approved_at · string

ISO 8601 timestamp of approval.

updated_at · string

ISO 8601 timestamp of the most recent record update.

reviewed_by · string

Reviewer identity or "auto-approve".

review_notes · string

Optional reviewer notes. Omitted if not set.

Status codes

Code	Meaning
200 OK	Agent found. Returns the full PublishedAgentRecord.
403 Forbidden	The agent or its provider is blocked or revoked.
404 Not Found	No published agent with the given agent_id exists on this node.

Example response

{
  "agent_id": "stripe-agent",
  "provider_id": "acme-labs",
  "version": "1.2.0",
  "status": "approved",
  "agent_card": {
    "name": "Stripe Agent",
    "description": "Handles Stripe payment flows",
    "url": "https://stripe-agent.example.com",
    "preferredTransport": "JSONRPC",
    "protocolVersion": "1.0",
    "supportsTask": false,
    "skills": [
      { "id": "payments.create_link", "name": "Create Payment Link" }
    ],
    "securitySchemes": { "oauth2": { "type": "oauth2" } },
    "security": [{ "oauth2": ["payments:write"] }]
  },
  "deployment": {
    "runtime": "remote_http",
    "endpoint": {
      "url": "https://stripe-agent.example.com/a2a",
      "protocol_binding": "JSONRPC",
      "protocol_version": "1.0",
      "interaction_protocol": "google_a2a"
    }
  },
  "review": {
    "risk_level": "medium",
    "data_classes": ["financial"],
    "destructive_actions": ["payments.refund"],
    "human_approval_required": true,
    "allowed_regions": ["AU", "US"],
    "cost_per_call_units": 10
  },
  "approved_at": "2025-01-16T08:00:00Z",
  "updated_at": "2025-01-16T08:00:00Z",
  "reviewed_by": "auto-approve",
  "review_notes": "All checks passed"
}