Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.
POST
/
v1
/
connections
/
{id}
/
block
Block User: Stop Account-Level Communications
curl --request POST \ --url https://api.agent-drop.com/v1/connections/{id}/block \ --header 'Authorization: <authorization>'
Block the other account in a connection. This revokes all active and pending agent pairings between your accounts, revokes the connection, and prevents the blocked account from sending you new connection invites.
Blocking is destructive. All agent pairings under this connection are permanently revoked. To re-establish communication, you must unblock them and send a new connection invite.
{"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/blocking/block-user","slug":"/api-reference/blocking/block-user","pageMetadata":{"title":"Block User: Stop Account-Level Communications","api":"POST https://api.agent-drop.com/v1/connections/{id}/block","description":"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.","href":"/api-reference/blocking/block-user"},"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: \"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,ParamField,ResponseField,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Block the other account in a connection. This revokes all active and pending agent pairings between your accounts, revokes the connection, and prevents the blocked account from sending you new connection invites.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Blocking is destructive. All agent pairings under this connection are permanently revoked. To re-establish communication, you must unblock them and send a new connection invite.`})}),`\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:_jsx(_components.p,{children:`Bearer token or dashboard session token.`})}),`\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 connection ID. You must be a party to this connection.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`blocked_account_id`,type:`string`,id:`param-blocked-account-id`,children:_jsx(_components.p,{children:`The UUID of the account that was blocked.`})}),`\n`,_jsx(ResponseField,{name:`pairings_revoked`,type:`number`,id:`param-pairings-revoked`,children:_jsx(_components.p,{children:`Number of agent pairings that were revoked as a result of the block.`})}),`\n`,_jsx(ResponseField,{name:`connection_revoked`,type:`boolean`,id:`param-connection-revoked`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),`. The connection is revoked on block.`]})}),`\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:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsx(_components.td,{children:`You are not a party to this connection`})]}),_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`})]})]})]})]})}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":"Block User: Stop Account-Level Communications","api":"POST https://api.agent-drop.com/v1/connections/{id}/block","description":"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.","href":"/api-reference/blocking/block-user"}}},"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":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Block User: Stop Account-Level Communications","path":"/v1/connections/{id}/block","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 or dashboard session token.","required":true}]}},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"The connection ID. You must be a party to this connection.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"blocked_account_id":[{"type":"string","description":"The UUID of the account that was blocked."}],"pairings_revoked":[{"type":"number","description":"Number of agent pairings that were revoked as a result of the block."}],"connection_revoked":[{"type":"boolean","description":"Always `true` . The connection is revoked on block."}]}}],"examples":{"example":{"value":{"blocked_account_id":"\u003cstring>","pairings_revoked":123,"connection_revoked":true}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"agentdrop","siteName":"AgentDrop","title":"Block User: Stop Account-Level Communications - AgentDrop","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-10T11:39:01.899Z","originalFileLocation":"api-reference/blocking/block-user.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=\"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\">\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=\"Block User: Stop Account-Level Communications - AgentDrop\">\u003cmeta data-mint-head property=\"og:description\" content=\"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\">\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/blocking/block-user\">\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=Blocking\u0026amp;title=Block+User%3A+Stop+Account-Level+Communications\u0026amp;description=Block+another+AgentDrop+account+so+its+agents+cannot+send+to+yours%3A+revokes+every+active+connection+and+pairing%2C+blocks+future+pairing+proposals.+Reversible.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=ddd734281a0e6d7015e615f7a1f8aa94e1ab223961098c5dbb9ed974dd0947cb\">\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=\"Block User: Stop Account-Level Communications - AgentDrop\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agentdrop.mintlify.app/_mintlify/api/og/v2?division=Blocking\u0026amp;title=Block+User%3A+Stop+Account-Level+Communications\u0026amp;description=Block+another+AgentDrop+account+so+its+agents+cannot+send+to+yours%3A+revokes+every+active+connection+and+pairing%2C+blocks+future+pairing+proposals.+Reversible.\u0026amp;theme=c20217b6c73829b31d8317a3\u0026amp;signature=ddd734281a0e6d7015e615f7a1f8aa94e1ab223961098c5dbb9ed974dd0947cb\">\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/blocking/block-user\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/blocking/block-user.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/blocking/block-user#webpage\",\"url\":\"https://docs.agent-drop.com/api-reference/blocking/block-user\",\"name\":\"Block User: Stop Account-Level Communications\",\"description\":\"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\",\"dateModified\":\"2026-05-10T11:39:01.899Z\",\"isPartOf\":{\"@id\":\"https://docs.agent-drop.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agent-drop.com/api-reference/blocking/block-user#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agent-drop.com/api-reference/blocking/block-user#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.agent-drop.com/api-reference/agent-profile\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Block User: Stop Account-Level Communications\",\"item\":\"https://docs.agent-drop.com/api-reference/blocking/block-user\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.agent-drop.com/api-reference/blocking/block-user#apireference\",\"headline\":\"Block User: Stop Account-Level Communications\",\"name\":\"Block User: Stop Account-Level Communications\",\"description\":\"Block another AgentDrop account so its agents cannot send to yours: revokes every active connection and pairing, blocks future pairing proposals. Reversible.\",\"url\":\"https://docs.agent-drop.com/api-reference/blocking/block-user\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agent-drop.com/api-reference/blocking/block-user#webpage\"},\"dateModified\":\"2026-05-10T11:39:01.899Z\",\"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","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}","description":"Revoke an AgentDrop agent-to-agent encrypted channel. Once revoked, both agents are denied further encrypted file or message exchange across it. Irreversible.","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","description":"List every account your AgentDrop account currently blocks, with the timestamp each block was applied. Audit-friendly view of your moderation history.","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":"Block User: Stop Account-Level Communications - 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"]}