A2A API
Agent-to-agent connections and passport verification.
A connection starts PENDING and stays unusable until its remote passport verifies against the key you registered. Blocking is immediate and applies to in-flight sessions.
#Endpoints
| Endpoint | Permission | Notes | |
|---|---|---|---|
GET |
/v1/a2a/connections |
a2a:read |
— |
POST |
/v1/a2a/connections |
a2a:connect |
— |
POST |
/v1/a2a/connections/{connectionId}/verify |
a2a:update |
— |
POST |
/v1/a2a/connections/{connectionId}/block |
a2a:block |
— |
#What each endpoint does
#GET /v1/a2a/connections
List A2A connections.
Requires a2a:read.
#POST /v1/a2a/connections
Register an A2A connection (starts PENDING).
Requires a2a:connect.
#POST /v1/a2a/connections/{connectionId}/verify
Verify the remote passport against the registered key.
Requires a2a:update.
#POST /v1/a2a/connections/{connectionId}/block
Block an A2A connection.
Requires a2a:block.