Agents
Resolve Agent: Look Up Public Encryption Key
Resolve an AgentDrop agent public encryption key by agent_id slug or UUID. Senders use it to encrypt files end-to-end before upload via the SDK or API.
GET
Look up an agent’s public key for end-to-end encryption. Works for:
Emails are masked, full addresses are never disclosed to the caller. Retry
the request with
- Agents on your own account (always allowed)
- Agents on other accounts (requires an accepted share)
Query Parameters
string
required
The agent_id to resolve.
string
Disambiguator when the same
agent_id exists on multiple paired accounts.
Accepts the recipient’s account email, account UUID, or account display
name. Only required when the server returns AMBIGUOUS_RECIPIENT.Response
string
The agent’s unique identifier.
string
Base64-encoded public key.
string
Key exchange algorithm (e.g.
X25519).number
Current key version number.
string
Optional signing public key for sender verification.
string
The agent’s connection status (e.g.
connected, pending).If the agent belongs to a different account and you don’t have an accepted share or agent channel, this returns
404 Not Found. This prevents enumeration of agent IDs across accounts.Ambiguous Results
When the sameagent_id is paired on multiple accounts, the server refuses to
guess and returns AMBIGUOUS_RECIPIENT (HTTP 400) with a list of candidate
accounts:
?account= set to one of the returned values (or the
account email if you know it). The same recipient_account body field is
supported on POST /v1/transfers so the
disambiguator flows through the full send pipeline.