A2A Control Plane

The A2A (Agent-to-Agent) control plane is CleverThis's management API. It allows programmatic control over every aspect of a workspace: namespaces, API keys, provider configuration, usage reporting, and billing. It is designed so that AI agents (and CI/CD pipelines) can manage CleverThis infrastructure on behalf of humans.

The A2A endpoint lives at /a2a and speaks JSON-RPC 2.0. All requests are POST with a JSON body containing a jsonrpc, method, params, and id field. Authentication uses ct_mgmt_ keys in the Authorization header.

Base request shape

{
  "jsonrpc": "2.0",
  "method": "namespace.method",
  "params": { ... },
  "id": 1
}

Method namespaces

Namespace	Description
workspaces	Workspace metadata and membership
namespaces	Namespace CRUD and endpoint management
keys	API key creation and revocation
providers	LLM provider credential management
usage	Usage reporting and statistics
billing	Wallet, credits, and Stripe operations

What's in this section

• Workspaces
• Namespaces
• Keys
• Providers
• Usage
• Billing

Example call

curl https://api.cleverthis.com/a2a \
  -H "Authorization: Bearer ct_mgmt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "namespaces.list", "params": {}, "id": 1}'

Coming soon

A full method reference with request/response schemas for every A2A method is being added to each subsection.