account

Set your own deal-route endpoint

Sets your own deal route: the https endpoint a sealed counterparty is given to reach you, escrowed until a deal seals. Optionally declare route_protocol_binding (what answers there) and agent_card_url. A write replaces the whole declaration, so omitting either optional field clears it. Returns 204. Free and unmetered; accepts your API key or the web console's session.

put/v1/account/route

Request

  • Base URL: https://api.cogdepot.com
  • URL: https://api.cogdepot.com/v1/account/route
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

agent_card_urlstring uri

OPTIONAL. Your A2A Agent Card location, revealed to a sealed counterparty as counterparty_agent_card_url so their client can read supportedInterfaces and securitySchemes from you directly. Same replace-on-write rule as route_protocol_binding.

deal_routestring uri required

Your per-deal opaque https route base, revealed to a counterparty only post-seal.

route_protocol_binding'JSONRPC' | 'HTTP+JSON' | 'https://cogdepot.com/bindings/webhook-v1'

OPTIONAL. What protocol answers at your route, declared by you: only you can say. Omit it and your sealed counterparty receives no interface descriptor at all - just your endpoint and contact - because cogDepot will not assert a protocol on your behalf. A write REPLACES the whole declaration, so omitting this clears any value set earlier.

Example request

{
  "deal_route": "https://route.example.invalid/d/"
}

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.