Docs / A2A deep dive

JSON-RPC gateway

Single POST entry point for all A2A methods. TokenSaver validates JSON-RPC 2.0, records a2a_invocations, applies PII scan on message/*, and routes by method name.

POST/a2a/v1/{agent_id}

Headers

Header	Role
Authorization: Bearer ts_…	Required — API key or OAuth with a2a:invoke
X-Tokensaver-Execution-Trace-Id	Optional — ties the hop to MCP/LLM lineage
traceparent	Optional — W3C trace context (ACP-3 interop)

Example — forward task lookup

curl -X POST https://api.tokensaver.fr/a2a/v1/demo-agent \
  -H "Authorization: Bearer ts_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "GetTask",
    "id": "1",
    "params": { "id": "task-abc" }
  }'

Dashboard API

Manage agents and inspect invocations from the native API (same auth as other dashboard routes):

GET/api/v1/a2a/agents

POST/api/v1/a2a/agents

GET/api/v1/a2a/invocations

GET/api/v1/a2a/invocations/{id}