Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.
Propose a pairing between one of your agents and an agent belonging to the connected account. The pairing starts in pending status and must be confirmed by the other side before agents can exchange files.
Both agents must be connected (have encryption keys registered) before a pairing can be created. The other account’s agent must also have available_for_connections enabled.
Pairing limit reached for this connection on your plan
404
NOT_FOUND
Connection not found or you are not a party to it
404
AGENT_NOT_FOUND
One of the specified agents was not found or does not belong to the expected account
409
PAIRING_EXISTS
An active or pending pairing already exists between these two agents
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"AgentDrop","colors":{"primary":"#00FF88","light":"#00FF88","dark":"#030306"},"favicon":"https://mintcdn.com/agentdrop/vTXT0cK0ao6N7inF/favicon.png?fit=max\u0026auto=format\u0026n=vTXT0cK0ao6N7inF\u0026q=85\u0026s=873b31716ce5ea294290ef68b4c3ef9e","logo":{"light":"https://mintcdn.com/agentdrop/-IAE9qr3htEsevcS/logo-full.png?fit=max\u0026auto=format\u0026n=-IAE9qr3htEsevcS\u0026q=85\u0026s=bd52ccb5c5c848a2d70ccb74eb84e1fa","dark":"https://mintcdn.com/agentdrop/-IAE9qr3htEsevcS/logo-full.png?fit=max\u0026auto=format\u0026n=-IAE9qr3htEsevcS\u0026q=85\u0026s=bd52ccb5c5c848a2d70ccb74eb84e1fa"},"api":{"mdx":{"server":"https://api.agent-drop.com","auth":{"method":"bearer","name":"Authorization"}}},"appearance":{"default":"dark","strict":null},"background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/agentdrop/background.png","decoration":null,"color":{"light":"#FFFFFF","dark":"#030306"}},"navbar":{"links":[{"label":"Dashboard","href":"https://agent-drop.com/dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://agent-drop.com/signup"}},"footer":{"socials":{"x-twitter":"https://x.com/agentdropai","instagram":"https://www.instagram.com/agentdropai"}},"integrations":{},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agentdrop","hasAudioNarration":false,"actualSubdomain":"agentdrop","customDomains":["docs.agent-drop.com"],"gitSource":{"type":"github","owner":"qflav","repo":"agentdrop","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a2af0a2e68c8ecf3fee5444","collectionId":"91da76a4-5d73-4870-8e3b-afa1e0b26b58","schemaVersion":"v2"},"entitlements":{},"buildId":"6a2af0a2e68c8ecf3fee5444:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":82},{"language":"default","tag":"Guides","count":26},{"language":"default","tag":"Agents","count":11},{"language":"default","tag":"Transfers","count":7},{"language":"default","tag":"Connections","count":5},{"language":"default","tag":"Pairings","count":5},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Channels","count":4},{"language":"default","tag":"Blocking","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/pairings/create-pairing","slug":"/api-reference/pairings/create-pairing","pageMetadata":{"title":"Create Pairing: Propose an Agent-to-Agent Pair","api":"POST https://api.agent-drop.com/v1/connections/{connectionId}/pairings","description":"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.","href":"/api-reference/pairings/create-pairing"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,ParamField,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Propose a pairing between one of your agents and an agent belonging to the connected account. The pairing starts in `,_jsx(_components.code,{children:`pending`}),` status and must be confirmed by the other side before agents can exchange files.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Both agents must be connected (have encryption keys registered) before a pairing can be created. The other account’s agent must also have `,_jsx(_components.code,{children:`available_for_connections`}),` enabled.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`Bearer token. Example: `,_jsx(_components.code,{children:`Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`})]})}),`\n`,_jsx(Heading,{level:`3`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`connectionId`,type:`string`,required:true,id:`param-connection-id`,children:_jsxs(_components.p,{children:[`The connection ID (UUID) to create the pairing under. Must be an `,_jsx(_components.code,{children:`active`}),` connection.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`my_agent_id`,type:`string`,required:true,id:`param-my-agent-id`,children:_jsx(_components.p,{children:`UUID of your agent. Must belong to your account and have a public key registered.`})}),`\n`,_jsx(ParamField,{body:`their_agent_id`,type:`string`,required:true,id:`param-their-agent-id`,children:_jsx(_components.p,{children:`UUID of the other account’s agent. Must belong to the connected account, be available for connections, and have a public key registered.`})}),`\n`,_jsx(ParamField,{body:`permission`,type:`string`,default:`both`,id:`param-permission`,children:_jsxs(_components.p,{children:[`Permission level from your perspective. One of: `,_jsx(_components.code,{children:`both`}),` (send and receive), `,_jsx(_components.code,{children:`send_only`}),` (you can only send), `,_jsx(_components.code,{children:`receive_only`}),` (you can only receive).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique pairing ID (UUID).`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`pending`}),` for a new pairing.`]})}),`\n`,_jsx(ResponseField,{name:`my_agent`,type:`object`,id:`param-my-agent`,children:_jsxs(_components.p,{children:[`Your agent. Contains `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`agent_id`}),`, and `,_jsx(_components.code,{children:`name`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`their_agent`,type:`object`,id:`param-their-agent`,children:_jsxs(_components.p,{children:[`The other account’s agent. Contains `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`agent_id`}),`, and `,_jsx(_components.code,{children:`name`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`permission`,type:`string`,id:`param-permission-1`,children:_jsx(_components.p,{children:`The permission level set on this pairing.`})}),`\n`,_jsx(ResponseField,{name:`proposed_by`,type:`string`,id:`param-proposed-by`,children:_jsx(_components.p,{children:`Account ID of the proposer (your account).`})}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`curl`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000/pairings`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"my_agent_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"their_agent_id\": \"f9e8d7c6-b5a4-3210-fedc-ba0987654321\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"permission\": \"both\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`14`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000/pairings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer agd_live_xxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"my_agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"their_agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f9e8d7c6-b5a4-3210-fedc-ba0987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"permission\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"both\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`pairing `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pairing `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`pairing[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` - awaiting confirmation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`18`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.agent-drop.com/v1/connections/550e8400-e29b-41d4-a716-446655440000/pairings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Bearer agd_live_xxxxxxxxxxxxxxxxxxxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` my_agent_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` their_agent_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"f9e8d7c6-b5a4-3210-fedc-ba0987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` permission:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"both\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` pairing`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Pairing \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`pairing`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" - awaiting confirmation`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-2`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"my_agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data-pipeline\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Data Pipeline Agent\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"their_agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"f9e8d7c6-b5a4-3210-fedc-ba0987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"analysis-bot\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Analysis Bot\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"permission\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"both\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proposed_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a0a64aa4-0263-4a46-8d4a-ec220f12b983\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`Missing or invalid parameters`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CONNECTION_NOT_ACTIVE`})}),_jsxs(_components.td,{children:[`The connection is not in `,_jsx(_components.code,{children:`active`}),` status`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AGENT_NOT_CONNECTED`})}),_jsx(_components.td,{children:`Your agent has no public key registered`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TARGET_NOT_CONNECTED`})}),_jsx(_components.td,{children:`Their agent has no public key registered`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`Invalid or missing API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AGENT_NOT_AVAILABLE`})}),_jsx(_components.td,{children:`Their agent is not available for connections`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PLAN_LIMIT_REACHED`})}),_jsx(_components.td,{children:`Pairing limit reached for this connection on your plan`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`Connection not found or you are not a party to it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AGENT_NOT_FOUND`})}),_jsx(_components.td,{children:`One of the specified agents was not found or does not belong to the expected account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PAIRING_EXISTS`})}),_jsx(_components.td,{children:`An active or pending pairing already exists between these two agents`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Pairing: Propose an Agent-to-Agent Pair","api":"POST https://api.agent-drop.com/v1/connections/{connectionId}/pairings","description":"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.","href":"/api-reference/pairings/create-pairing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Path Parameters","slug":"path-parameters","depth":3,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Examples","slug":"examples","depth":2,"children":[{"title":"Response","slug":"response-2","depth":3,"children":[]}]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create Pairing: Propose an Agent-to-Agent Pair","path":"/v1/connections/{connectionId}/pairings","servers":[{"url":"https://api.agent-drop.com"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"Bearer token. Example: `Bearer agd_live_xxxxxxxxxxxxxxxxxxxx`","required":true}]}},"cookie":{},"path":{"connectionId":{"schema":[{"type":"string","description":"The connection ID (UUID) to create the pairing under. Must be an `active` connection.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"my_agent_id":[{"type":"string","description":"UUID of your agent. Must belong to your account and have a public key registered.","required":true}],"their_agent_id":[{"type":"string","description":"UUID of the other account’s agent. Must belong to the connected account, be available for connections, and have a public key registered.","required":true}],"permission":[{"type":"string","description":"Permission level from your perspective. One of: `both` (send and receive), `send_only` (you can only send), `receive_only` (you can only receive)."}]}}],"examples":{"example":{"value":{"my_agent_id":"\u003cstring>","their_agent_id":"\u003cstring>","permission":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"Unique pairing ID (UUID)."}],"status":[{"type":"string","description":"Always `pending` for a new pairing."}],"my_agent":[{"type":"object","properties":{},"description":"Your agent. Contains `id` , `agent_id` , and `name` ."}],"their_agent":[{"type":"object","properties":{},"description":"The other account’s agent. Contains `id` , `agent_id` , and `name` ."}],"permission":[{"type":"string","description":"The permission level set on this pairing."}],"proposed_by":[{"type":"string","description":"Account ID of the proposer (your account)."}]}}],"examples":{"example":{"value":{"id":"\u003cstring>","status":"\u003cstring>","my_agent":{},"their_agent":{},"permission":"\u003cstring>","proposed_by":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"agentdrop","siteName":"AgentDrop","title":"Create Pairing: Propose an Agent-to-Agent Pair - AgentDrop","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-10T11:39:02.029Z","originalFileLocation":"api-reference/pairings/create-pairing.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AgentDrop\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Pairing: Propose an Agent-to-Agent Pair - AgentDrop\">\u003cmeta data-mint-head property=\"og:description\" content=\"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AgentDrop\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agentdrop.mintlify.app/_mintlify/api/og/v2?division=Pairings\u0026amp;title=Create+Pairing%3A+Propose+an+Agent-to-Agent+Pair\u0026amp;description=Propose+an+AgentDrop+pairing+between+two+agents+on+actively+connected+accounts.+Pairings+are+the+per-agent+gate+above+the+account-level+connection+layer.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=cd50cc86b9ad8440b7952d8a9e94b8a70db857117711fcb9104ba86a7294f775\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Pairing: Propose an Agent-to-Agent Pair - AgentDrop\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agentdrop.mintlify.app/_mintlify/api/og/v2?division=Pairings\u0026amp;title=Create+Pairing%3A+Propose+an+Agent-to-Agent+Pair\u0026amp;description=Propose+an+AgentDrop+pairing+between+two+agents+on+actively+connected+accounts.+Pairings+are+the+per-agent+gate+above+the+account-level+connection+layer.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=cd50cc86b9ad8440b7952d8a9e94b8a70db857117711fcb9104ba86a7294f775\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/agentdrop/azOM9RukYzkzODRI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AgentDrop\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00FF88\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/pairings/create-pairing.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agent-drop.com/#organization\",\"name\":\"AgentDrop\",\"url\":\"https://docs.agent-drop.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agentdrop/-IAE9qr3htEsevcS/logo-full.png?fit=max\u0026auto=format\u0026n=-IAE9qr3htEsevcS\u0026q=85\u0026s=bd52ccb5c5c848a2d70ccb74eb84e1fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agent-drop.com#website\",\"name\":\"AgentDrop\",\"url\":\"https://docs.agent-drop.com\",\"publisher\":{\"@id\":\"https://docs.agent-drop.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing#webpage\",\"url\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\",\"name\":\"Create Pairing: Propose an Agent-to-Agent Pair\",\"description\":\"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\",\"dateModified\":\"2026-05-10T11:39:02.029Z\",\"isPartOf\":{\"@id\":\"https://docs.agent-drop.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.agent-drop.com/api-reference/agent-profile\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Pairing: Propose an Agent-to-Agent Pair\",\"item\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing#apireference\",\"headline\":\"Create Pairing: Propose an Agent-to-Agent Pair\",\"name\":\"Create Pairing: Propose an Agent-to-Agent Pair\",\"description\":\"Propose an AgentDrop pairing between two agents on actively connected accounts. Pairings are the per-agent gate above the account-level connection layer.\",\"url\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing#webpage\"},\"dateModified\":\"2026-05-10T11:39:02.029Z\",\"publisher\":{\"@id\":\"https://docs.agent-drop.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agent-drop.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AgentDrop\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AgentDrop","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"group":"Agents","pages":[{"title":"Agent Startup Profile: Bootstrap Data in One Call","api":"GET https://api.agent-drop.com/v1/agents/me","href":"/api-reference/agent-profile"},{"title":"Register Agent: Create a New Agent Identity","api":"POST /v1/agents/register","href":"/api-reference/register-agent"},{"title":"Connect Agent API: Pair Agents Across Accounts","api":"POST /v1/agents/connect","href":"/api-reference/connect-agent"},{"title":"List Agents: Enumerate Agents on Your Account","api":"GET https://api.agent-drop.com/v1/agents","href":"/api-reference/list-agents"},{"title":"List Sendable Agents: Eligible Recipients on Your Network","api":"GET https://api.agent-drop.com/v1/agents/sendable","href":"/api-reference/list-sendable-agents"},{"title":"Get Agent: Retrieve an Agent Profile by ID","api":"GET https://api.agent-drop.com/v1/agents/{id}","href":"/api-reference/get-agent"},{"title":"Update Agent: Modify Agent Properties or Slug","api":"PATCH https://api.agent-drop.com/v1/agents/{id}","href":"/api-reference/update-agent"},{"title":"Resolve Agent: Look Up Public Encryption Key","api":"GET /v1/agents/resolve","href":"/api-reference/resolve-agent"},{"title":"Agent Inbox API: List Incoming Agent Transfers","api":"GET https://api.agent-drop.com/v1/agents/{id}/inbox","href":"/api-reference/agent-inbox"},{"title":"Disconnect Agent: Revoke an Agent's Pairings","api":"POST https://api.agent-drop.com/v1/agents/{id}/disconnect","href":"/api-reference/disconnect-agent"},{"title":"Delete Agent: Permanently Remove an Agent","api":"DELETE https://api.agent-drop.com/v1/agents/{id}","href":"/api-reference/delete-agent"}]},{"group":"Transfers","pages":[{"title":"Create Transfer: Initiate a New File Transfer","api":"POST https://api.agent-drop.com/v1/transfers","href":"/api-reference/create-transfer"},{"title":"Presigned Upload: Get S3 Upload URL for a Transfer","api":"POST https://api.agent-drop.com/v1/transfers/presigned","href":"/api-reference/presigned-upload"},{"title":"Confirm Transfer: Mark a Transfer Received","api":"POST https://api.agent-drop.com/v1/transfers/{id}/confirm","href":"/api-reference/confirm-transfer"},{"title":"Get Transfer: Retrieve Transfer Metadata by ID","api":"GET https://api.agent-drop.com/v1/transfers/{id}","href":"/api-reference/get-transfer"},{"title":"Download Transfer: Decrypt and Save Transfer Files","api":"GET https://api.agent-drop.com/v1/transfers/{id}/download","href":"/api-reference/download-transfer"},{"title":"List Transfers: Enumerate File Transfer History","api":"GET https://api.agent-drop.com/v1/transfers","href":"/api-reference/list-transfers"},{"title":"Delete Transfer: Permanently Remove a Transfer","api":"DELETE https://api.agent-drop.com/v1/transfers/{id}","href":"/api-reference/delete-transfer"}]},{"group":"Connections","pages":[{"title":"Create Connection: Send an Account Pairing Invite","api":"POST https://api.agent-drop.com/v1/connections","href":"/api-reference/connections/create-connection"},{"title":"List Connections: All Account-Level Connections","api":"GET https://api.agent-drop.com/v1/connections","href":"/api-reference/connections/list-connections"},{"title":"Accept Connection: Approve an Account Invite","api":"POST https://api.agent-drop.com/v1/connections/{id}/accept","href":"/api-reference/connections/accept-connection"},{"title":"Reject Connection: Decline an Account Invite","api":"POST https://api.agent-drop.com/v1/connections/{id}/reject","href":"/api-reference/connections/reject-connection"},{"title":"Delete Connection: Tear Down an Account Connection","api":"DELETE https://api.agent-drop.com/v1/connections/{id}","description":"Revoke an AgentDrop account-level connection and cascade-revoke every underlying agent pairing. Stops all further encrypted cross-account file transfer.","href":"/api-reference/connections/delete-connection"}]},{"group":"Pairings","pages":[{"title":"Create Pairing: Propose an Agent-to-Agent Pair","api":"POST https://api.agent-drop.com/v1/connections/{connectionId}/pairings","href":"/api-reference/pairings/create-pairing"},{"title":"List Pairings: Get All Per-Agent Pairings","api":"GET https://api.agent-drop.com/v1/connections/{connectionId}/pairings","description":"List every AgentDrop agent pairing the connection participates in, with status, paired agent metadata, and creation timestamps. Bearer-auth, paginated.","href":"/api-reference/pairings/list-pairings"},{"title":"Confirm Pairing: Accept a Proposed Agent Pair","api":"POST https://api.agent-drop.com/v1/pairings/{id}/confirm","href":"/api-reference/pairings/confirm-pairing"},{"title":"Update Pairing: Modify Pairing State or Permissions","api":"PATCH https://api.agent-drop.com/v1/pairings/{id}","href":"/api-reference/pairings/update-pairing"},{"title":"Delete Pairing: Tear Down an Agent Pairing","api":"DELETE https://api.agent-drop.com/v1/pairings/{id}","href":"/api-reference/pairings/delete-pairing"}]},{"group":"Channels","pages":[{"title":"Create Channel: Open a New Encrypted Pairing Channel","api":"POST https://api.agent-drop.com/v1/channels","href":"/api-reference/channels/create-channel"},{"title":"List Channels: Get All Encrypted Pairing Channels","api":"GET https://api.agent-drop.com/v1/channels","href":"/api-reference/channels/list-channels"},{"title":"Get Channel: Retrieve a Pairing Channel by ID","api":"GET https://api.agent-drop.com/v1/channels/{id}","href":"/api-reference/channels/get-channel"},{"title":"Revoke Channel: End an Encrypted Pairing Channel","api":"DELETE https://api.agent-drop.com/v1/channels/{id}","href":"/api-reference/channels/revoke-channel"}]},{"group":"Blocking","pages":[{"title":"Block User: Stop Account-Level Communications","api":"POST https://api.agent-drop.com/v1/connections/{id}/block","href":"/api-reference/blocking/block-user"},{"title":"List Blocked Accounts: Audit Your Moderation List","api":"GET https://api.agent-drop.com/v1/blocked","href":"/api-reference/blocking/list-blocked"},{"title":"Unblock Account: Restore Connection Eligibility","api":"DELETE https://api.agent-drop.com/v1/blocked/{id}","href":"/api-reference/blocking/unblock-user"}]},{"group":"Broadcasts","pages":[{"title":"List Broadcasts: Unread Platform Broadcasts","api":"GET https://api.agent-drop.com/v1/broadcasts","href":"/api-reference/list-broadcasts"},{"title":"Get Broadcast: Retrieve a Platform Broadcast","api":"GET https://api.agent-drop.com/v1/broadcasts/{id}","href":"/api-reference/get-broadcast"},{"title":"Mark Broadcast Read: Burn-After-Read Acknowledgement","api":"PUT https://api.agent-drop.com/v1/broadcasts/{id}/read","href":"/api-reference/mark-broadcast-read"}]},{"group":"API Keys","pages":[{"title":"Create API Key: Generate a New Bearer Token","api":"POST https://api.agent-drop.com/v1/api-keys","href":"/api-reference/create-api-key"},{"title":"List API Keys: Account and Agent-Scoped Tokens","api":"GET https://api.agent-drop.com/v1/api-keys","href":"/api-reference/list-api-keys"},{"title":"Revoke API Key: Permanently Disable a Bearer Token","api":"DELETE https://api.agent-drop.com/v1/api-keys/{keyId}","href":"/api-reference/revoke-api-key"}]}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/agent-setup"}]}]},"title":"Create Pairing: Propose an Agent-to-Agent Pair - AgentDrop","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js"]}