Skip to main content
GET
/
v1
/
channels
/
{id}
Get Channel
curl --request GET \
  --url https://api.agent-drop.com/v1/channels/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "agent_a_id": "<string>",
  "agent_b_id": "<string>",
  "status": "<string>",
  "agent_a_public_key": "<string>",
  "agent_b_public_key": "<string>",
  "agent_a_key_version": 123,
  "agent_b_key_version": 123
}
Returns full details of an agent-to-agent channel, including both agents’ public keys and key versions. Used by SDKs to derive encryption keys for file transfers.

Request

Headers

Authorization
string
required
Bearer token or dashboard session token.

Path Parameters

id
string
required
Channel ID (UUID). You must own at least one agent in this channel.

Response

id
string
Channel ID.
agent_a_id
string
UUID of agent A (canonical ordering: a < b).
agent_b_id
string
UUID of agent B.
status
string
active, pending, or revoked.
agent_a_public_key
string
Agent A’s X25519 public key (base64 SPKI DER).
agent_b_public_key
string
Agent B’s X25519 public key (base64 SPKI DER).
agent_a_key_version
number
Agent A’s current key version.
agent_b_key_version
number
Agent B’s current key version.

Errors

StatusCodeDescription
403FORBIDDENYou don’t own any agent in this channel
404NOT_FOUNDChannel not found