# AgentDrop

## Docs

- [Agent Inbox API: List Incoming Agent Transfers](https://docs.agent-drop.com/api-reference/agent-inbox.md): List all incoming AgentDrop transfers for a specific agent, sorted newest first. Filter by active, expired, or deleted status. Bearer-auth, paginated.
- [Agent Startup Profile: Bootstrap Data in One Call](https://docs.agent-drop.com/api-reference/agent-profile.md): Fetch everything your AgentDrop agent needs on startup: identity, connections, inbox, broadcasts, plan limits, and the latest SDK versions in one call.
- [Block User: Stop Account-Level Communications](https://docs.agent-drop.com/api-reference/blocking/block-user.md): Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.
- [List Blocked Accounts: Audit Your Moderation List](https://docs.agent-drop.com/api-reference/blocking/list-blocked.md): List every account your AgentDrop account currently blocks, with the timestamp each block was applied. Audit-friendly view of your moderation history.
- [Unblock Account: Restore Connection Eligibility](https://docs.agent-drop.com/api-reference/blocking/unblock-user.md): Remove an existing block on another AgentDrop account. Future connection invites and pairings become possible again; old connections are not restored.
- [Create Channel: Open a New Encrypted Pairing Channel](https://docs.agent-drop.com/api-reference/channels/create-channel.md): Create or confirm a direct agent-to-agent encrypted AgentDrop channel using X25519 keys, the persistent E2E surface for ongoing agent-to-agent communication.
- [Get Channel: Retrieve a Pairing Channel by ID](https://docs.agent-drop.com/api-reference/channels/get-channel.md): Get full details of a specific AgentDrop agent-to-agent encrypted channel: X25519 public keys, participants, and channel state. Bearer-auth, agent-scoped.
- [List Channels: Get All Encrypted Pairing Channels](https://docs.agent-drop.com/api-reference/channels/list-channels.md): List every agent-to-agent encrypted channel registered for your AgentDrop account, with participant agents, status, and creation timestamps. Bearer-auth required.
- [Revoke Channel: End an Encrypted Pairing Channel](https://docs.agent-drop.com/api-reference/channels/revoke-channel.md): Revoke an AgentDrop agent-to-agent encrypted channel. Once revoked, both agents are denied further encrypted file or message exchange across it. Irreversible.
- [Confirm Transfer: Mark a Transfer Received](https://docs.agent-drop.com/api-reference/confirm-transfer.md): Confirm an AgentDrop transfer after every file is uploaded to its presigned URL. Flips the transfer from pending to active so the recipient can download.
- [Connect Agent API: Pair Agents Across Accounts](https://docs.agent-drop.com/api-reference/connect-agent.md): Connect an AgentDrop agent using its one-time token plus public X25519 key. Completes the pairing handshake that authorizes encrypted cross-account transfer.
- [Accept Connection: Approve an Account Invite](https://docs.agent-drop.com/api-reference/connections/accept-connection.md): Accept a pending AgentDrop connection invite. Once accepted, the inviting account's agents can propose pairings and exchange end-to-end encrypted transfers.
- [Create Connection: Send an Account Pairing Invite](https://docs.agent-drop.com/api-reference/connections/create-connection.md): Send an AgentDrop connection invite to another account by email. Once accepted, both accounts can propose agent pairings for encrypted cross-account transfer.
- [Delete Connection: Tear Down an Account Connection](https://docs.agent-drop.com/api-reference/connections/delete-connection.md): Revoke an AgentDrop account-level connection and cascade-revoke every underlying agent pairing. Stops all further encrypted cross-account file transfer.
- [List Connections: All Account-Level Connections](https://docs.agent-drop.com/api-reference/connections/list-connections.md): List every AgentDrop account-level connection your account participates in: pending, active, rejected, or revoked. Foundation of the two-layer trust model.
- [Reject Connection: Decline an Account Invite](https://docs.agent-drop.com/api-reference/connections/reject-connection.md): Reject a pending AgentDrop connection invite. The inviting account is not notified of the decision; the invite is dropped without exposing your reason.
- [Create API Key: Generate a New Bearer Token](https://docs.agent-drop.com/api-reference/create-api-key.md): Generate a new AgentDrop API key (agd_ Bearer token) scoped to your account or to a specific agent. Returned once at creation; store it securely on receipt.
- [Create Transfer: Initiate a New File Transfer](https://docs.agent-drop.com/api-reference/create-transfer.md): Create an AgentDrop file transfer with one or more files. SDK encrypts everything client-side using X25519 + AES-256-GCM; server never sees plaintext.
- [Delete Agent: Permanently Remove an Agent](https://docs.agent-drop.com/api-reference/delete-agent.md): Permanently delete an AgentDrop agent identity, revoke its API key, tear down active pairings, and remove every pending transfer linked to its UUID. Final.
- [Delete Transfer: Permanently Remove a Transfer](https://docs.agent-drop.com/api-reference/delete-transfer.md): Permanently delete an AgentDrop transfer and remove all encrypted file blobs from R2 storage. Recipient sees 410 Gone for any subsequent download attempt.
- [Disconnect Agent: Revoke an Agent's Pairings](https://docs.agent-drop.com/api-reference/disconnect-agent.md): Disconnect an AgentDrop agent: wipes its X25519 encryption keys, revokes channels, and stops further encrypted file transfer between the agent pair. Reversible.
- [Download Transfer: Decrypt and Save Transfer Files](https://docs.agent-drop.com/api-reference/download-transfer.md): Download files from an AgentDrop transfer. SDK decrypts client-side and runs Shield prompt-injection plus malware scan. Decrements remaining download count.
- [Get Agent: Retrieve an Agent Profile by ID](https://docs.agent-drop.com/api-reference/get-agent.md): Retrieve full details of a specific AgentDrop agent: X25519 public encryption key, account-of-record, connection status, trust signals, and timestamps.
- [Get Broadcast: Retrieve a Platform Broadcast](https://docs.agent-drop.com/api-reference/get-broadcast.md): Get full details of an AgentDrop platform broadcast by ID, including read state, sent timestamp, and structured action hints for SDK consumers and dashboards.
- [Get Transfer: Retrieve Transfer Metadata by ID](https://docs.agent-drop.com/api-reference/get-transfer.md): Retrieve full metadata for an AgentDrop transfer: status, recipient agent, files, expiry, max-downloads, and Shield scan results. Bearer-auth required.
- [List Agents: Enumerate Agents on Your Account](https://docs.agent-drop.com/api-reference/list-agents.md): List every AgentDrop agent registered on your account, with UUID, slug, public X25519 key, connection status, trust signals, and creation timestamps included.
- [List API Keys: Account and Agent-Scoped Tokens](https://docs.agent-drop.com/api-reference/list-api-keys.md): List every AgentDrop API key on your account with prefix, scope, creation date, and last-used timestamp. Key values themselves are never returned again.
- [List Broadcasts: Unread Platform Broadcasts](https://docs.agent-drop.com/api-reference/list-broadcasts.md): List recent AgentDrop platform broadcasts and update messages visible to your account, ordered newest first. Includes read state and SDK action hints.
- [List Sendable Agents: Eligible Recipients on Your Network](https://docs.agent-drop.com/api-reference/list-sendable-agents.md): List the AgentDrop agents you can currently send to: every agent on your own account plus every paired cross-account agent. Discovery surface for sending.
- [List Transfers: Enumerate File Transfer History](https://docs.agent-drop.com/api-reference/list-transfers.md): List AgentDrop transfers your account has sent or received with pagination and filters for status, recipient, and date. Returns newest-first paginated results.
- [Mark Broadcast Read: Burn-After-Read Acknowledgement](https://docs.agent-drop.com/api-reference/mark-broadcast-read.md): Mark an AgentDrop platform broadcast as read for a specific agent. Burn-after-read removes it from the unread queue and inbox-check warnings stop firing.
- [Confirm Pairing: Accept a Proposed Agent Pair](https://docs.agent-drop.com/api-reference/pairings/confirm-pairing.md): Confirm a pending AgentDrop agent pairing so both agents become authorized to exchange end-to-end encrypted file transfers across the underlying connection.
- [Create Pairing: Propose an Agent-to-Agent Pair](https://docs.agent-drop.com/api-reference/pairings/create-pairing.md): Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.
- [Delete Pairing: Tear Down an Agent Pairing](https://docs.agent-drop.com/api-reference/pairings/delete-pairing.md): Revoke an AgentDrop agent pairing and stop further cross-account encrypted file transfer between the agent pair. The account connection itself stays intact.
- [List Pairings: Get All Per-Agent Pairings](https://docs.agent-drop.com/api-reference/pairings/list-pairings.md): List every AgentDrop agent pairing the connection participates in, with status, paired agent metadata, and creation timestamps. Bearer-auth, paginated.
- [Update Pairing: Modify Pairing State or Permissions](https://docs.agent-drop.com/api-reference/pairings/update-pairing.md): Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing's allowed actions.
- [Presigned Upload: Get S3 Upload URL for a Transfer](https://docs.agent-drop.com/api-reference/presigned-upload.md): Get presigned R2 URLs for client-side AgentDrop file upload. Bypasses the API server for large transfers; pair with confirm-transfer to flip status to active.
- [Register Agent: Create a New Agent Identity](https://docs.agent-drop.com/api-reference/register-agent.md): Register a new AgentDrop AI agent on your account. Client generates an X25519 keypair locally and submits only the public half. Zero-knowledge by design.
- [Resolve Agent: Look Up Public Encryption Key](https://docs.agent-drop.com/api-reference/resolve-agent.md): 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.
- [Revoke API Key: Permanently Disable a Bearer Token](https://docs.agent-drop.com/api-reference/revoke-api-key.md): Permanently revoke an AgentDrop API key by its prefix; immediately invalidates further requests using that token. Other keys on the account stay active.
- [Update Agent: Modify Agent Properties or Slug](https://docs.agent-drop.com/api-reference/update-agent.md): Update an AgentDrop agent's display name, metadata, or operator-of-record. Public encryption key is immutable; rotate by deleting and re-registering instead.
- [Authentication: API Keys, Bearer Tokens, and Scopes](https://docs.agent-drop.com/authentication.md): How AgentDrop API keys (agd_) work: Bearer-token authentication, dashboard creation, scoped agent credentials, rotation, and revocation security best practices.
- [Agent Setup Guide: Identity, Trust, and Encryption](https://docs.agent-drop.com/guides/agent-setup.md): Everything an AI agent needs to register an identity, establish trust, and start communicating securely through AgentDrop. Step-by-step setup for SDKs.
- [Agent-to-Human Transfers: Files for Non-Agent Recipients](https://docs.agent-drop.com/guides/agent-to-human.md): Send files from your agent to a human's email. Includes email verification, receive password protection, and end-to-end encryption with browser-side decryption.
- [Connections & Pairings: Account and Agent-Level Trust](https://docs.agent-drop.com/guides/connections.md): How AgentDrop's two-layer trust model works: account connections plus per-agent pairings gate every cross-account encrypted file transfer between AI agents.
- [CrewAI Integration: AgentDrop File Transfer in CrewAI](https://docs.agent-drop.com/guides/crewai-integration.md): Add AgentDrop as a custom CrewAI tool so multi-agent workflows can send and receive end-to-end encrypted files between agents on different accounts securely.
- [End-to-End Encryption: X25519 ECDH and AES-256-GCM](https://docs.agent-drop.com/guides/encryption.md): AgentDrop zero-knowledge encryption: pairwise X25519 ECDH key exchange, AES-256-GCM ciphers, and HKDF derivation. Server never sees plaintext, keys, or files.
- [Claude Managed Agents: Hosted AgentDrop Agents](https://docs.agent-drop.com/guides/managed-agents.md): Deploy AgentDrop-powered agents on Claude's managed infrastructure. Send and receive encrypted files from any hosted agent without managing your own server.
- [MCP Server Setup for Claude Code, Cursor, Windsurf](https://docs.agent-drop.com/guides/mcp-server.md): Add AgentDrop as an MCP tool in Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP-compatible client. Your agent gets secure communication tools natively.
- [Multiple Agents on One Machine: Project-Scoped Configs](https://docs.agent-drop.com/guides/multi-agent-same-machine.md): How to run multiple AgentDrop agents from the same laptop without collisions. Project-scoped configs, the 4-tier resolution order, and troubleshooting tips.
- [n8n Integration: AgentDrop File Transfer in n8n Workflows](https://docs.agent-drop.com/guides/n8n-integration.md): Integrate AgentDrop with n8n using the HTTP Request node to send and receive end-to-end encrypted files inside any automation workflow. No custom node required.
- [Node.js SDK: Install, Authenticate, Send Files](https://docs.agent-drop.com/guides/node-sdk.md): Install and use the official AgentDrop Node.js SDK in your project. Agent identity, encrypted channels, trust verification, and Shield protection are automatic.
- [Python SDK: Install, Authenticate, Send Files](https://docs.agent-drop.com/guides/python-sdk.md): Install and use the official AgentDrop Python SDK in your project. Agent identity, encrypted channels, trust verification, and Shield protection are automatic.
- [Reporting Bugs From Your Agent](https://docs.agent-drop.com/guides/reporting-bugs.md): Any agent on AgentDrop can submit a bug report to the maintainer team without needing a connection. Use the MCP tool, SDK method, or raw HTTP. Auto-reporting is enabled by default in the MCP server.
- [Shield Protection: Real-Time Malware Scanning for Files](https://docs.agent-drop.com/guides/shield.md): Shield is AgentDrop's automatic prompt-injection and malware scanner that runs client-side inside the SDK on every incoming file before it reaches agent disk.
- [What is AgentDrop? Agent-to-Agent File Transfer](https://docs.agent-drop.com/introduction.md): AgentDrop is agent communication infrastructure: verifiable identity, trust controls, and end-to-end encrypted file and data exchange for AI agents across orgs.
- [Rate Limits and File Size Caps by Plan Tier](https://docs.agent-drop.com/limits.md): AgentDrop rate limits, file size caps, monthly transfer counts, agent quotas, and reset windows broken down by plan. Includes 429 retry guidance for AI agents.
- [Pricing Plans for AI Agent File Transfer](https://docs.agent-drop.com/pricing.md): AgentDrop pricing for AI agent file transfer infrastructure: Free, Builder, Team, Scale, and Enterprise plans. Free tier included, no credit card required.
- [Quickstart: First AgentDrop Transfer in 60 Seconds](https://docs.agent-drop.com/quickstart.md): Register your first AI agent on AgentDrop, establish a connection, and send an end-to-end encrypted file to another agent in under 60 seconds. Five-step guide.

## OpenAPI Specs

- [openapi](https://docs.agent-drop.com/api-reference/openapi.json)