Update Pairing: Modify Pairing State or Permissions
Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing’s allowed actions.
PATCH
/
v1
/
pairings
/
{id}
Update Pairing: Modify Pairing State or Permissions
Update the permission level on an existing pairing. Changing the permission resets the pairing to pending status, requiring the other side to re-confirm.
Either side of the pairing can update the permission. The permission you provide is from your perspective, the system automatically flips it for storage if you are not the original proposer.
{ "id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90", "permission": "send_only", "status": "pending", "message": "Permission updated. The other side must re-confirm the pairing."}
{"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/update-pairing","slug":"/api-reference/pairings/update-pairing","pageMetadata":{"title":"Update Pairing: Modify Pairing State or Permissions","api":"PATCH https://api.agent-drop.com/v1/pairings/{id}","description":"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing's allowed actions.","href":"/api-reference/pairings/update-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: \"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing’s allowed actions.\"\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:[`Update the permission level on an existing pairing. Changing the permission resets the pairing to `,_jsx(_components.code,{children:`pending`}),` status, requiring the other side to re-confirm.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Either side of the pairing can update the permission. The permission you provide is from your perspective, the system automatically flips it for storage if you are not the original proposer.`})}),`\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:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The pairing ID (UUID) to update.`})}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsx(ParamField,{body:`permission`,type:`string`,required:true,id:`param-permission`,children:_jsxs(_components.p,{children:[`New permission level from your perspective. One of: `,_jsx(_components.code,{children:`both`}),`, `,_jsx(_components.code,{children:`send_only`}),`, `,_jsx(_components.code,{children:`receive_only`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id-1`,children:_jsx(_components.p,{children:`The pairing ID.`})}),`\n`,_jsx(ResponseField,{name:`permission`,type:`string`,id:`param-permission-1`,children:_jsx(_components.p,{children:`The new permission from your perspective.`})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`pending`}),` after an update (requires re-confirmation).`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsxs(_components.p,{children:[`Confirmation message: `,_jsx(_components.code,{children:`Permission updated. The other side must re-confirm the pairing.`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`curl`,numberOfLines:`4`,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:`4`,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:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.agent-drop.com/v1/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90`}),_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:` '{\"permission\": \"send_only\"}'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`10`,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:`10`,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.patch(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.agent-drop.com/v1/pairings/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:`#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:`{`}),_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:`\"send_only\"`}),_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:`result `}),_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:`(result[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# \"pending\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`14`,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:`14`,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/pairings/d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90\"`}),_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:` \"PATCH\"`}),_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:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`permission:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"send_only\"`}),_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:` result`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`result`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_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:`6`,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:`6`,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:` \"permission\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"send_only\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Permission updated. The other side must re-confirm the pairing.\"`})]}),`\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:`Invalid permission value`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_STATUS`})}),_jsx(_components.td,{children:`Cannot update a revoked pairing`})]}),_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:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`Pairing not found or you are not a party to it`})]})]})]})]})}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":"Update Pairing: Modify Pairing State or Permissions","api":"PATCH https://api.agent-drop.com/v1/pairings/{id}","description":"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing's allowed actions.","href":"/api-reference/pairings/update-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":"Update Pairing: Modify Pairing State or Permissions","path":"/v1/pairings/{id}","servers":[{"url":"https://api.agent-drop.com"}],"method":"patch","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":{"id":{"schema":[{"type":"string","description":"The pairing ID (UUID) to update.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"permission":[{"type":"string","description":"New permission level from your perspective. One of: `both` , `send_only` , `receive_only` .","required":true}]}}],"examples":{"example":{"value":{"permission":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"The pairing ID."}],"permission":[{"type":"string","description":"The new permission from your perspective."}],"status":[{"type":"string","description":"Always `pending` after an update (requires re-confirmation)."}],"message":[{"type":"string","description":"Confirmation message: `Permission updated. The other side must re-confirm the pairing.`"}]}}],"examples":{"example":{"value":{"id":"\u003cstring>","permission":"\u003cstring>","status":"\u003cstring>","message":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"agentdrop","siteName":"AgentDrop","title":"Update Pairing: Modify Pairing State or Permissions - AgentDrop","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-10T11:39:02.018Z","originalFileLocation":"api-reference/pairings/update-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=\"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing\u0026#x27;s allowed actions.\">\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=\"Update Pairing: Modify Pairing State or Permissions - AgentDrop\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing\u0026#x27;s allowed actions.\">\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/update-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=Update+Pairing%3A+Modify+Pairing+State+or+Permissions\u0026amp;description=Update+the+permission+level+on+an+existing+AgentDrop+agent+pairing+without+recreating+it.+Useful+when+widening+or+narrowing+the+pairing%27s+allowed+actions.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=337dedd71e824af2a6fe93cc53dd9d5e8ecd412ba8c4e48b38a78e9f121e07cc\">\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=\"Update Pairing: Modify Pairing State or Permissions - AgentDrop\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing\u0026#x27;s allowed actions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agentdrop.mintlify.app/_mintlify/api/og/v2?division=Pairings\u0026amp;title=Update+Pairing%3A+Modify+Pairing+State+or+Permissions\u0026amp;description=Update+the+permission+level+on+an+existing+AgentDrop+agent+pairing+without+recreating+it.+Useful+when+widening+or+narrowing+the+pairing%27s+allowed+actions.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=337dedd71e824af2a6fe93cc53dd9d5e8ecd412ba8c4e48b38a78e9f121e07cc\">\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/update-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/update-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/update-pairing#webpage\",\"url\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing\",\"name\":\"Update Pairing: Modify Pairing State or Permissions\",\"description\":\"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing's allowed actions.\",\"dateModified\":\"2026-05-10T11:39:02.018Z\",\"isPartOf\":{\"@id\":\"https://docs.agent-drop.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/update-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\":\"Pairings\",\"item\":\"https://docs.agent-drop.com/api-reference/pairings/create-pairing\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update Pairing: Modify Pairing State or Permissions\",\"item\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing#apireference\",\"headline\":\"Update Pairing: Modify Pairing State or Permissions\",\"name\":\"Update Pairing: Modify Pairing State or Permissions\",\"description\":\"Update the permission level on an existing AgentDrop agent pairing without recreating it. Useful when widening or narrowing the pairing's allowed actions.\",\"url\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agent-drop.com/api-reference/pairings/update-pairing#webpage\"},\"dateModified\":\"2026-05-10T11:39:02.018Z\",\"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}","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","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","description":"Confirm a pending AgentDrop agent pairing so both agents become authorized to exchange end-to-end encrypted file transfers across the underlying connection.","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}","description":"Revoke an AgentDrop agent pairing and stop further cross-account encrypted file transfer between the agent pair. The account connection itself stays intact.","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":"Update Pairing: Modify Pairing State or Permissions - 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"]}