Each operation is authorized and applied independently, with the same rules as its single endpoint. A connection token can run update_status operations, but update_credit_limit and delete operations need a personal access token. Poll the returned status_url to retrieve the completed batch result.
Completed batch result
When the task succeeds, result is an agent_batch_result with a results array. Each entry includes index, action, agent_id, and outcome; use index to match it to the request because an agent can appear more than once.
Outcome
Additional fields
update_status success
status, pause_reason, and last_edited_time
update_credit_limit success
credit_limit and last_edited_time
delete success
status (deleted) and deleted_at
Error
error, a standard API error object
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Notion-Version
enum<string>
required
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11
Body
application/json
operations
object[]
required
The operations to apply, at least one and at most 100. Operations are applied in the order given, and the batch is not atomic: each operation succeeds or fails on its own, and per-operation outcomes are reported in the async task's result.
Required array length: 1 - 100 elements
One action to apply to one agent. Each operation is authorized and applied on its own.
Option 1
Option 2
Option 3
Show child attributes
Response
object
string
required
Allowed value: "async_task"
id
string
required
Minimum string length: 1
status_url
string
required
Minimum string length: 1
created_time
string<date-time>
required
operation
object
required
Show child attributes
status
enum<string>
required
Available options:
queued,
running,
retrying
poll_after_seconds
integer
required
Required range: x >= 0
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Notion Docs","colors":{"primary":"#000","light":"#097fe8","dark":"#0075de"},"logo":{"light":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d","dark":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/dark.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=a8404879d171debac543bb6c1482c909","href":"/"},"favicon":"https://mintcdn.com/notion-demo/LHm9qfrJYJOPRxs6/favicon.png?fit=max\u0026auto=format\u0026n=LHm9qfrJYJOPRxs6\u0026q=85\u0026s=0668f0b3334eef21f0cdc65b390d22d9","api":{"openapi":["openapi.json","openapi-undocumented.json","openapi-adminApi.json"]},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#0f0f0f"}},"navbar":{"links":[{"href":"https://www.notion.com/login","label":"Log in"}],"primary":{"type":"button","label":"Developer portal","href":"https://www.notion.so/developers"}},"footer":{"socials":{"x":"https://x.com/NotionDevs","slack":"https://join.slack.com/t/notiondevs/shared_invite/zt-3u9oid9q8-HLUBmMVWYK~g9HFo4U4raA"}},"seo":{"metatags":{"og:image":"/images/og-image.png"}},"fonts":{"family":"NotionInter"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notion-demo","hasAudioNarration":false,"actualSubdomain":"notion-demo","customDomains":["developers.notion.com"],"gitSource":{"type":"github","owner":"makenotion","repo":"notion-next","deployBranch":"main","contentDirectory":"src/server-publicApiDocs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff3ce31325fbb87b9bb9b2","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":142},{"language":"default","tag":"Endpoints","count":135},{"language":"default","tag":"Guides","count":62},{"language":"default","tag":"Admin API","count":58},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Agents","count":23},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Notion API","count":17},{"language":"default","tag":"Data APIs","count":17},{"language":"default","tag":"Pages","count":17}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"NotionInter\";font-weight:400;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Regular.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Medium.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-SemiBold.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:normal;font-display:optional;src:url(\"/fonts/NotionInter-Bold.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:400;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-Italic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-MediumItalic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-SemiBoldItalic.woff2\") format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:italic;font-display:optional;src:url(\"/fonts/NotionInter-BoldItalic.woff2\") format(\"woff2\")}:root{--font-notion-stack:\n\t\t\"NotionInter\", \"Inter\", -apple-system, \"system-ui\", \"Segoe UI\", Helvetica,\n\t\tArial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"}html,body,button,input,select,textarea,h1,h2,h3,h4,h5,h6{font-family:var(--font-notion-stack)}.card>.flex.items-center:has([data-component-part=\"card-icon\"]){align-items:flex-start}[data-component-part=\"card-content\"]{font-size:0.875rem;line-height:1.45}.navbar-link>a{background-color:transparent!important}.navbar-link>a:hover{background-color:#37352f0a!important}html.dark .navbar-link>a:hover{background-color:rgba(255, 255, 255, 0.055)!important}.bg-primary-dark.rounded-xl{border-radius:8px!important}#search-bar-entry{background-color:#37352f0a!important;color:#7d7a75!important}#search-bar-entry:hover{background-color:#37352f1a!important}#search-bar-entry svg{color:#7d7a75!important}#search-bar-entry:hover svg{color:#37352f!important}html.dark #search-bar-entry{background-color:rgba(255, 255, 255, 0.055)!important;color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover{background-color:rgba(255, 255, 255, 0.129)!important}html.dark #search-bar-entry svg{color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover svg{color:#ffffff!important}#search-bar-entry-mobile,#search-bar-entry-mobile svg{color:#7d7a75!important;background-color:#7d7a75!important}#search-bar-entry-mobile:hover,#search-bar-entry-mobile:hover svg{color:#37352f!important;background-color:#37352f!important}html.dark #search-bar-entry-mobile,html.dark #search-bar-entry-mobile svg{color:rgba(255, 255, 255, 0.5)!important;background-color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry-mobile:hover,html.dark #search-bar-entry-mobile:hover svg{color:#ffffff!important;background-color:#ffffff!important}button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:#37352f0a!important}button[data-component-part=\"theme-preference-menu-trigger\"]:hover,button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"]{background-color:#37352f1a!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:rgba(255, 255, 255, 0.055)!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]:hover,html.dark button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"]{background-color:rgba(255, 255, 255, 0.129)!important}button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:#7d7a75!important}button[data-component-part=\"theme-preference-menu-trigger\"]:hover svg,button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"] svg{color:#37352f!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:rgba(255, 255, 255, 0.5)!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]:hover svg,html.dark button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"] svg{color:#ffffff!important}#navbar [class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #navbar [class*=\"border-gray-800\"]{border-color:rgba(255, 255, 255, 0.094)!important}.nav-tabs-item div[class*=\"bg-gray-200\"]{background-color:#e6e5e3!important}html.dark .nav-tabs-item div[class*=\"bg-gray-700\"]{background-color:rgba(255, 255, 255, 0.18)!important}#sidebar-content[class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #sidebar-content[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}.sidebar-nav-group-divider{background-color:#e6e5e3!important}html.dark .sidebar-nav-group-divider{background-color:rgba(255, 255, 255, 0.094)!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"][class*=\"text-gray-700\"]{color:#37352f!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"][class*=\"hover:text-gray-900\"]:hover{color:#37352f!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"] svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}html:not(.dark) :is(a,button)[class*=\"outline-offset\"]:hover svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a,button)[class*=\"outline-offset\"] svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a,button)[class*=\"outline-offset\"]:hover svg[class*=\"text-gray-400\"][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}.card[class*=\"border-gray-950\"]{border-color:#e6e5e3!important}html.dark .card[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}[data-component-part=\"card-title\"]{color:#37352f!important}html.dark [data-component-part=\"card-title\"]{color:#ffffff!important}[data-component-part=\"card-content\"]{color:#7d7a75!important}html.dark [data-component-part=\"card-content\"]{color:#ada9a3!important}:is(a,button)[class*=\"outline-offset\"][class*=\"rounded-xl\"]{border-radius:6px!important}a[class*=\"text-shadow\"]{text-shadow:none!important;font-weight:600!important}.sidebar-group :is(a,button,span){hyphens:none!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"text-primary-light\"]{color:#ffffff!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"bg-primary-light\"]{background-color:rgba(255, 255, 255, 0.129)!important}:is(a,button)[class*=\"outline-offset\"][class*=\"bg-primary/10\"]{background-color:#37352f1a!important}:is(a,button)[class*=\"outline-offset\"][class*=\"hover:bg-gray-600\"]:hover{background-color:#37352f0a!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"hover:bg-gray-200\"]:hover{background-color:rgba(255, 255, 255, 0.055)!important}html.dark #table-of-contents-content li[data-active],html.dark #table-of-contents-content li[data-active]>a{border-color:#ffffff!important}html.dark #table-of-contents-content li[data-active]>a{color:#ffffff!important}html.dark a.nav-tabs-item[class*=\"text-primary\"]{color:#ffffff!important}html.dark a.nav-tabs-item div[class*=\"bg-primary-light\"]{background-color:#ffffff!important}.eyebrow{color:#78736f!important}html.dark .eyebrow{color:#a3a39e!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #sidebar-content{display:none!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-container{max-width:none!important;margin-left:0!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-area{margin-left:0!important;margin-right:0!important}html[data-current-path=\"/page/changelog\"] [data-component-part=\"update-content\"]{font-size:1rem}.sidebar-group-header{color:#78736f!important}html.dark .sidebar-group-header{color:#a3a39e!important}html.dark [class*=\"prose-invert\"]{color:#c7c7c7!important;--tw-prose-invert-body: #c7c7c7 !important;--tw-prose-invert-bullets: #c7c7c7 !important;--tw-prose-invert-counters: #c7c7c7 !important}html.dark h1#page-title{color:#ffffff!important}html.dark #header p{color:#c7c7c7!important}html.dark #table-of-contents-content a{color:#c7c7c7!important}html.dark .sidebar-group a:not([class*=\"text-shadow\"]),html.dark .sidebar-group button{color:#c7c7c7!important}html.dark #table-of-contents-content a:hover,html.dark .sidebar-group a:not([class*=\"text-shadow\"]):hover,html.dark .sidebar-group button:hover,html.dark a.nav-tabs-item:hover{color:#ffffff!important}#content a.link{color:inherit!important;text-decoration:underline!important;text-decoration-color:rgba(55, 53, 47, 0.25)!important;text-underline-offset:3px!important;text-decoration-thickness:1px!important;border-bottom:0!important;font-weight:inherit!important}#content a.link:hover{color:inherit!important;text-decoration-color:currentColor!important}html.dark #content a.link{text-decoration-color:rgba(255, 255, 255, 0.25)!important}html.dark #content a.link:hover{text-decoration-color:currentColor!important}.callout[class*=\"bg-blue\"]{background-color:#e5f2fc!important;border-color:#b6d4f3!important}.callout[class*=\"bg-blue\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-blue\"] [data-component-part=\"callout-icon\"] svg{color:#2783de!important}.callout[class*=\"bg-blue\"] [data-component-part=\"callout-content\"]{color:#355f8b!important}.callout[class*=\"bg-green\"]{background-color:#e8f1ec!important;border-color:#bed9c9!important}.callout[class*=\"bg-green\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-green\"] [data-component-part=\"callout-icon\"] svg{color:#46a171!important}.callout[class*=\"bg-green\"] [data-component-part=\"callout-content\"]{color:#37674c!important}.callout[class*=\"bg-yellow\"]{background-color:#f9f3dc!important;border-color:#e8d497!important}.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-icon\"] svg{color:#d8a32f!important}.callout[class*=\"bg-yellow\"] [data-component-part=\"callout-content\"]{color:#836426!important}.callout[class*=\"bg-red\"]{background-color:#fce9e7!important;border-color:#f0c5be!important}.callout[class*=\"bg-red\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-red\"] [data-component-part=\"callout-icon\"] svg{color:#e56458!important}.callout[class*=\"bg-red\"] [data-component-part=\"callout-content\"]{color:#924943!important}.callout[class*=\"bg-neutral\"]{background-color:#f0efed!important;border-color:#e6e5e3!important}.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"],.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"] svg{color:#5f5e59!important}.callout[class*=\"bg-neutral\"] [data-component-part=\"callout-content\"]{color:#494846!important}html.dark .callout[class*=\"bg-blue\"]{background-color:rgba(39, 131, 222, 0.12)!important;border-color:rgba(39, 131, 222, 0.3)!important}html.dark .callout[class*=\"bg-green\"]{background-color:rgba(70, 161, 113, 0.12)!important;border-color:rgba(70, 161, 113, 0.3)!important}html.dark .callout[class*=\"bg-yellow\"]{background-color:rgba(216, 163, 47, 0.12)!important;border-color:rgba(216, 163, 47, 0.3)!important}html.dark .callout[class*=\"bg-red\"]{background-color:rgba(229, 100, 88, 0.12)!important;border-color:rgba(229, 100, 88, 0.3)!important}html.dark .callout[class*=\"bg-neutral\"]{background-color:rgba(255, 255, 255, 0.05)!important;border-color:rgba(255, 255, 255, 0.12)!important}html.dark .callout[class*=\"bg-blue\"] [data-component-part=\"callout-content\"]{color:#9dc0ea!important}html.dark .callout[class*=\"bg-green\"] [data-component-part=\"callout-content\"]{color:#a6c7b4!important}html.dark .callout[class*=\"bg-yellow\"] [data-component-part=\"callout-content\"]{color:#e2ca88!important}html.dark .callout[class*=\"bg-red\"] [data-component-part=\"callout-content\"]{color:#e0aea6!important}html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-content\"]{color:#bcbab6!important}html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"],html.dark .callout[class*=\"bg-neutral\"] [data-component-part=\"callout-icon\"] svg{color:#ada9a3!important}.callout a.link,#content .callout a.link{color:inherit!important;text-decoration:underline!important;border-bottom:0!important}.callout a.link:hover,#content .callout a.link:hover{color:inherit!important;text-decoration:underline!important}[data-component-part=\"card-icon\"] img{filter:brightness(0) saturate(100%) invert(31%) sepia(85%) saturate(2280%)\n\t\thue-rotate(196deg) brightness(96%) contrast(101%)}html.dark [data-component-part=\"card-icon\"] img{filter:brightness(0) saturate(100%) invert(45%) sepia(98%) saturate(1480%)\n\t\thue-rotate(196deg) brightness(101%) contrast(96%)}[data-component-part=\"card-icon\"]>svg{width:1.25rem!important;height:1.25rem!important;mask-size:contain!important;-webkit-mask-size:contain!important}.card{transition:box-shadow 180ms ease-out,\n\t\tborder-color 180ms ease-out}.card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:transparent!important;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.06),\n\t\t0 4px 10px rgba(15, 15, 15, 0.05),\n\t\t0 1px 3px rgba(15, 15, 15, 0.04)!important}html.dark .card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:rgba(255, 255, 255, 0.18)!important;box-shadow:none!important}a[class*=\"border-gray-200/70\"][class*=\"rounded-xl\"][class*=\"py-3\"][class*=\"px-4\"]{border:0!important;padding:0!important}[data-component-part=\"code-block-root\"],[data-component-part=\"code-block-root\"] pre,[data-component-part=\"code-block-root\"] code,[data-component-part=\"code-block-root\"] code *{font-size:12px!important;line-height:20px!important}#page-context-menu [class*=\"rounded-l-xl\"]{border-radius:6px 0 0 6px!important}#page-context-menu [class*=\"rounded-r-xl\"]{border-radius:0 6px 6px 0!important}#page-context-menu [class*=\"text-sm\"]{font-size:12px!important}#page-context-menu :is(button,a)[class*=\"bg-gray\"],#page-context-menu :is(button,a)[class*=\"border-gray\"]{background-color:transparent!important;border-color:#e6e5e3!important}#page-context-menu :is(button,a):hover{background-color:#37352f0a!important}html.dark #page-context-menu :is(button,a)[class*=\"bg-gray\"],html.dark #page-context-menu :is(button,a)[class*=\"border-gray\"]{border-color:rgba(255, 255, 255, 0.094)!important}html.dark #page-context-menu :is(button,a):hover{background-color:rgba(255, 255, 255, 0.055)!important}[data-component-part=\"update-label\"]{background-color:#f7f6f3!important;color:#5f5e59!important;font-size:14px!important;line-height:20px!important;font-weight:400!important}html.dark [data-component-part=\"update-label\"]{background-color:rgba(255, 255, 255, 0.04)!important;color:#bcbab6!important}[class*=\"text-tooltip-foreground\"]{background-color:#1f1f1d!important;color:#ffffff!important;border-color:#1f1f1d!important}"}]}
{"page":{"pagePath":"reference/notion-agent-apis/batch-manage-agent","slug":"/reference/notion-agent-apis/batch-manage-agent","pageMetadata":{"title":"Batch manage agent","description":"Asynchronously apply multiple agent management operations.","openapi":"post /v1/agents/batch","href":"/reference/notion-agent-apis/batch-manage-agent"},"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: \"Asynchronously apply multiple agent management operations.\"\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,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Each operation is authorized and applied independently, with the same rules as its single endpoint. A connection token can run `,_jsx(_components.code,{children:`update_status`}),` operations, but `,_jsx(_components.code,{children:`update_credit_limit`}),` and `,_jsx(_components.code,{children:`delete`}),` operations need a personal access token. Poll the returned `,_jsx(_components.code,{children:`status_url`}),` to retrieve the completed batch result.`]}),`\n`,_jsx(Heading,{level:`3`,id:`completed-batch-result`,children:`Completed batch result`}),`\n`,_jsxs(_components.p,{children:[`When the task succeeds, `,_jsx(_components.code,{children:`result`}),` is an `,_jsx(_components.code,{children:`agent_batch_result`}),` with a `,_jsx(_components.code,{children:`results`}),` array. Each entry includes `,_jsx(_components.code,{children:`index`}),`, `,_jsx(_components.code,{children:`action`}),`, `,_jsx(_components.code,{children:`agent_id`}),`, and `,_jsx(_components.code,{children:`outcome`}),`; use `,_jsx(_components.code,{children:`index`}),` to match it to the request because an agent can appear more than once.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Outcome`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Additional fields`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`update_status`}),` success`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`pause_reason`}),`, and `,_jsx(_components.code,{children:`last_edited_time`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`update_credit_limit`}),` success`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`credit_limit`}),` and `,_jsx(_components.code,{children:`last_edited_time`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`delete`}),` success`]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`status`}),` (`,_jsx(_components.code,{children:`deleted`}),`) and `,_jsx(_components.code,{children:`deleted_at`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Error`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`error`}),`, a standard API error object`]})]})]})]})]})}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":"Batch manage agent","description":"Asynchronously apply multiple agent management operations.","openapi":"post /v1/agents/batch","href":"/reference/notion-agent-apis/batch-manage-agent"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Completed batch result","slug":"completed-batch-result","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/notion-demo/f3af24179eebc764/mcp-section-label.js","/_mintlify/custom/notion-demo/96b92b5a9cb7e11c/mcp-tool-section-redirects.js"],"openApiReferenceData":{"operation":{"summary":"Apply many agent operations","operationId":"agent-batch","x-notion-sdk-method":"agents.batch","tags":["Agents"],"x-codeSamples":[{"lang":"javascript","label":"TypeScript SDK","source":"import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.batch({\n operations: [\n {\n action: \"update_status\",\n agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\",\n fields: { status: \"disabled\" }\n }\n ]\n})"}],"x-notion-docs-ref":"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent","parameters":["3e8d7f1c-dd47-4e12-b7e3-585dc1c5ebe4"],"requestBody":"442a3254-b4f3-4a2c-a1ab-9cea227a6719","responses":{"200":"62ecade8-3c6e-4b88-95ee-c3593086430e","400":"fb98d227-0725-40c0-989d-0163d8c66972","401":"9480d42f-7df0-4428-960b-ab07f508c1a9","403":"dd957309-fbef-42da-9b29-42b01356d2fc","404":"7e6f0e5e-e235-43fa-bb90-49fb4cef7031","406":"466514cb-d53c-42e8-b0a9-eb692d50da81","409":"b468f905-e262-4ef4-8f1d-75e7d4922b8d","429":"49dfbba9-66fe-4377-a612-7628fcfdd71d","500":"f06e323d-0f7e-475e-832f-623271b7c457","503":"7b5151d3-e3eb-4dca-931b-6988968e98f2","504":"8e4ca608-bba8-4f08-801a-ebf88cbfd415","529":"693ced44-d858-4d52-9e3a-3efc6d59a4eb"},"method":"post","type":"path","servers":["2c852185-817e-41b9-a119-a2d9c7a56bef"],"security":["23c7697b-01d6-4756-9e53-15c190c2a020"],"path":"/v1/agents/batch","baseUrlOptions":["https://api.notion.com"],"title":"Apply many agent operations","description":"Asynchronously apply multiple agent management operations.","codeSamples":[{"label":"TypeScript SDK","lang":"javascript","source":"import { Client } from \"@notionhq/client\"\n\nconst notion = new Client({ auth: process.env.NOTION_API_KEY })\n\nconst response = await notion.agents.batch({\n operations: [\n {\n action: \"update_status\",\n agent_id: \"1f0c7c06-781b-4987-9986-5c8dd3028013\",\n fields: { status: \"disabled\" }\n }\n ]\n})"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"3e8d7f1c-dd47-4e12-b7e3-585dc1c5ebe4":{"name":"Notion-Version","in":"header","required":true,"schema":{"enum":["2026-03-11"],"type":"string","isRequired":true,"description":"The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operations":{"type":"array","items":{"oneOf":[{"type":"object","description":"One action to apply to one agent. Each operation is authorized and applied on its own.","required":["action","agent_id","fields"],"properties":{"action":{"type":"string","const":"update_status","description":"Enable or disable one agent, equivalent to `PATCH /v1/agents/:agent_id/status`.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.action","typeLabel":"string"},"agent_id":{"oneOf":[{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.agent_id.oneOf.0","typeLabel":"string"},{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","const":"notion_ai","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.agent_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.agent_id","typeLabel":"string"},"fields":{"type":"object","properties":{"status":{"type":"string","enum":["active","disabled"],"description":"\"active\" to re-enable an agent disabled through this API, or \"disabled\" to turn it off.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.fields.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["status"],"description":"The status to apply to this agent.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.0.fields","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"One action to apply to one agent. Each operation is authorized and applied on its own.","required":["action","agent_id","fields"],"properties":{"action":{"type":"string","const":"update_credit_limit","description":"Set or clear one agent's credit limit, equivalent to `PATCH /v1/agents/:agent_id/credit_limit`. Requires a personal access token whose user has full access to the agent.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.action","typeLabel":"string"},"agent_id":{"oneOf":[{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.agent_id.oneOf.0","typeLabel":"string"},{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","const":"notion_ai","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.agent_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.agent_id","typeLabel":"string"},"fields":{"type":"object","properties":{"credit_limit":{"oneOf":[{"type":"integer","description":"The per-agent credit limit as a non-negative integer, or null to clear the limit.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.fields.credit_limit.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The per-agent credit limit as a non-negative integer, or null to clear the limit.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.fields.credit_limit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.fields.credit_limit","typeLabel":"integer | null"}},"additionalProperties":false,"required":["credit_limit"],"description":"The credit limit to apply to this agent.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.1.fields","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"One action to apply to one agent. Each operation is authorized and applied on its own.","required":["action","agent_id"],"properties":{"action":{"type":"string","const":"delete","description":"Soft-delete one agent, equivalent to `DELETE /v1/agents/:agent_id`.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.action","typeLabel":"string"},"agent_id":{"oneOf":[{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.agent_id.oneOf.0","typeLabel":"string"},{"type":"string","description":"The agent ID (a UUID), or `notion_ai` for the personal agent. Endpoint-specific restrictions still apply.","const":"notion_ai","isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.agent_id.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"operations.items.[INDEX].oneOf.2.agent_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"operations.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"operations.items.[INDEX]","typeLabel":"object"},"maxItems":100,"minItems":1,"description":"The operations to apply, at least one and at most 100. Operations are applied in the order given, and the batch is not atomic: each operation succeeds or fails on its own, and per-operation outcomes are reported in the async task's result.","isRequired":true,"uniqueKey":"operations","typeLabel":"object[]"}},"additionalProperties":false,"required":["operations"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"operations":[{"action":"update_status","agent_id":"\u003cstring>","fields":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"62ecade8-3c6e-4b88-95ee-c3593086430e":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["object","id","status","status_url","created_time","operation","poll_after_seconds"],"additionalProperties":false,"properties":{"object":{"type":"string","const":"async_task","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"status_url":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"status_url","typeLabel":"string"},"created_time":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_time","typeLabel":"string\u003cdate-time>"},"operation":{"type":"object","required":["surface","name"],"additionalProperties":false,"properties":{"surface":{"type":"string","enum":["rest","mcp"],"isRequired":true,"uniqueKey":"operation.surface","typeLabel":"enum\u003cstring>"},"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"operation.name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"operation","typeLabel":"object"},"status":{"type":"string","enum":["queued","running","retrying"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"poll_after_seconds":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"poll_after_seconds","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"async_task","id":"\u003cstring>","status_url":"\u003cstring>","created_time":"2023-11-07T05:31:56Z","operation":{"surface":"rest","name":"\u003cstring>"},"status":"queued","poll_after_seconds":1}}},"exampleType":"generated"}},"exampleType":"generated"},"fb98d227-0725-40c0-989d-0163d8c66972":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["invalid_json","invalid_request_url","invalid_request","missing_version","invalid_beta","validation_error","invalid_credit_limit"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":400,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"invalid_json","status":400,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"9480d42f-7df0-4428-960b-ab07f508c1a9":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["unauthorized"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":401,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"unauthorized","status":401,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"dd957309-fbef-42da-9b29-42b01356d2fc":{"description":"","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.0.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"enum":["restricted_resource","status_change_not_allowed"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.0.additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"oneOf.0.additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["code","status","additional_data","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.1.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"additional_data":{"type":"object","required":["tool_error_code","tool_error_class","tool_error_retryable","recovery_kind"],"properties":{"tool_error_code":{"const":"workspace_credits_exhausted","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_code","typeLabel":"any"},"tool_error_class":{"const":"entitlement_required","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_class","typeLabel":"any"},"tool_error_retryable":{"const":"false","isRequired":true,"uniqueKey":"oneOf.1.additional_data.tool_error_retryable","typeLabel":"any"},"recovery_kind":{"enum":["contact_workspace_owner","open_workspace_credit_settings"],"description":"The recovery action selected by Notion for the caller.","type":"string","isRequired":true,"uniqueKey":"oneOf.1.additional_data.recovery_kind","typeLabel":"enum\u003cstring>"},"recovery_url":{"type":"string","format":"uri","description":"Present when recovery_kind directs the caller to a settings page.","uniqueKey":"oneOf.1.additional_data.recovery_url","typeLabel":"string\u003curi>"}},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.1.additional_data.additionalProperties","typeLabel":"string | string[]"},"isRequired":true,"uniqueKey":"oneOf.1.additional_data","typeLabel":"object"},"code":{"const":"workspace_credits_exhausted","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"any"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"any"}},"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["code","status","additional_data","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"oneOf.2.object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.message","typeLabel":"string"},"additional_data":{"type":"object","required":["tool_error_code","tool_error_class","tool_error_retryable","recovery_kind"],"properties":{"tool_error_code":{"const":"agent_credit_limit_reached","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_code","typeLabel":"any"},"tool_error_class":{"const":"entitlement_required","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_class","typeLabel":"any"},"tool_error_retryable":{"const":"false","isRequired":true,"uniqueKey":"oneOf.2.additional_data.tool_error_retryable","typeLabel":"any"},"recovery_kind":{"enum":["contact_workspace_owner","none","open_agent_settings","request_agent_limit_increase","request_pending"],"description":"The recovery action selected by Notion for the caller.","type":"string","isRequired":true,"uniqueKey":"oneOf.2.additional_data.recovery_kind","typeLabel":"enum\u003cstring>"},"recovery_url":{"type":"string","format":"uri","description":"Present when recovery_kind directs the caller to a settings page.","uniqueKey":"oneOf.2.additional_data.recovery_url","typeLabel":"string\u003curi>"}},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.2.additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"oneOf.2.additional_data.additionalProperties","typeLabel":"string | string[]"},"isRequired":true,"uniqueKey":"oneOf.2.additional_data","typeLabel":"object"},"code":{"const":"agent_credit_limit_reached","isRequired":true,"uniqueKey":"oneOf.2.code","typeLabel":"any"},"status":{"const":403,"isRequired":true,"uniqueKey":"oneOf.2.status","typeLabel":"any"}},"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"restricted_resource","status":403,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"7e6f0e5e-e235-43fa-bb90-49fb4cef7031":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["object_not_found","directory_not_found"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":404,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"object_not_found","status":404,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"466514cb-d53c-42e8-b0a9-eb692d50da81":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["row_limit_exceeded"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":406,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"row_limit_exceeded","status":406,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"b468f905-e262-4ef4-8f1d-75e7d4922b8d":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["conflict_error","idempotency_key_reused","agent_deleted"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":409,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"conflict_error","status":409,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"49dfbba9-66fe-4377-a612-7628fcfdd71d":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["rate_limited"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":429,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"rate_limited","status":429,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"f06e323d-0f7e-475e-832f-623271b7c457":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["internal_server_error"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":500,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"internal_server_error","status":500,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"7b5151d3-e3eb-4dca-931b-6988968e98f2":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["service_unavailable"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":503,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"service_unavailable","status":503,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"8e4ca608-bba8-4f08-801a-ebf88cbfd415":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["gateway_timeout"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":504,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"gateway_timeout","status":504,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"693ced44-d858-4d52-9e3a-3efc6d59a4eb":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["code","status","object","message"],"properties":{"object":{"const":"error","isRequired":true,"uniqueKey":"object","typeLabel":"any"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"enum":["service_overload"],"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"status":{"const":529,"isRequired":true,"uniqueKey":"status","typeLabel":"any"},"additional_data":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"additional_data.additionalProperties.oneOf.1.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_data.additionalProperties.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"additional_data.additionalProperties","typeLabel":"string | string[]"},"uniqueKey":"additional_data","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"error","message":"\u003cstring>","code":"service_overload","status":529,"additional_data":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"23c7697b-01d6-4756-9e53-15c190c2a020":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"2c852185-817e-41b9-a119-a2d9c7a56bef":{"url":"https://api.notion.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"notion-demo","siteName":"Notion Docs","title":"Batch manage agent - Notion Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T20:53:42.891Z","originalFileLocation":"reference/notion-agent-apis/batch-manage-agent.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=\"system\"}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=\"Asynchronously apply multiple agent management operations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Batch manage agent - Notion Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Asynchronously apply multiple agent management operations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notion Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://notion-demo.mintlify.site/images/og-image.png\">\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=\"Batch manage agent - Notion Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Asynchronously apply multiple agent management operations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notion-demo.mintlify.site/images/og-image.png\">\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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/notion-agent-apis/batch-manage-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.notion.com/#organization\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.notion.com#website\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent#webpage\",\"url\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent\",\"name\":\"Batch manage agent\",\"description\":\"Asynchronously apply multiple agent management operations.\",\"dateModified\":\"2026-11-11T20:53:42.891Z\",\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://developers.notion.com/reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://developers.notion.com/reference/notion-agent-apis/query-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Batch manage agent\",\"item\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent#apireference\",\"headline\":\"Batch manage agent\",\"name\":\"Batch manage agent\",\"description\":\"Asynchronously apply multiple agent management operations.\",\"url\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent\",\"mainEntityOfPage\":{\"@id\":\"https://developers.notion.com/reference/notion-agent-apis/batch-manage-agent#webpage\"},\"image\":\"https://developers.notion.com/images/og-image.png\",\"dateModified\":\"2026-11-11T20:53:42.891Z\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","agentPointerHref":"/reference/notion-agent-apis/batch-manage-agent.md","siteName":"Notion Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/notion-api/quick-start"}]},{"tab":"API Reference","groups":[{"group":"Notion API","pages":[{"title":"Introduction","href":"/reference/intro"},{"title":"Pagination","href":"/reference/pagination"},{"title":"Connection capabilities","href":"/reference/capabilities"},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/reference/webhooks"},{"title":"Event types \u0026 delivery","href":"/reference/webhooks-events-delivery"}]},{"title":"Request limits","href":"/reference/request-limits"},{"title":"Workspace block limits","href":"/reference/workspace-block-limits"},{"title":"Status codes","href":"/reference/status-codes"},{"group":"Versioning","pages":[{"title":"Versioning","sidebarTitle":"Overview","href":"/reference/versioning"},{"title":"Changes by version","href":"/reference/changes-by-version"}]}]},{"group":"Objects","pages":[{"group":"Block","pages":[{"title":"Block","sidebarTitle":"Overview","href":"/reference/block"},{"title":"Rich text","href":"/reference/rich-text"}]},{"group":"Page","pages":[{"title":"Page","sidebarTitle":"Overview","href":"/reference/page"},{"group":"Page properties","pages":[{"title":"Page property values","sidebarTitle":"Page values","href":"/reference/page-property-values"},{"title":"Page property items","sidebarTitle":"Property items","href":"/reference/property-item-object"}]}]},{"title":"Database","href":"/reference/database"},{"group":"Data source","pages":[{"title":"Data source","sidebarTitle":"Overview","href":"/reference/data-source"},{"title":"Data source properties","sidebarTitle":"Property schemas","href":"/reference/property-object"}]},{"title":"View","href":"/reference/view"},{"group":"Comment","pages":[{"title":"Comment","sidebarTitle":"Overview","href":"/reference/comment-object"},{"title":"Comment attachment","href":"/reference/comment-attachment"},{"title":"Comment display name","href":"/reference/comment-display-name"}]},{"group":"File","pages":[{"title":"File","sidebarTitle":"Overview","href":"/reference/file-object"},{"title":"File Upload","href":"/reference/file-upload"}]},{"title":"User","href":"/reference/user"},{"title":"Parent","href":"/reference/parent-object"},{"title":"Emoji and icon","href":"/reference/emoji-and-icon"},{"title":"Unfurl attribute (Link Previews)","href":"/reference/unfurl-attribute-object"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Authentication","sidebarTitle":"Overview","href":"/reference/authentication"},{"title":"Create a token","openapi":"post /v1/oauth/token","href":"/reference/create-a-token"},{"openapi":"post /v1/oauth/introspect","title":"Introspect a token","href":"/reference/introspect-token"},{"openapi":"post /v1/oauth/revoke","title":"Revoke a token","href":"/reference/revoke-token"},{"title":"Refresh a token","openapi":"post /v1/oauth/token","href":"/reference/refresh-a-token"}]},{"group":"Async tasks","icon":"/icons/nds/arrowCircleLoopForward.svg","pages":[{"openapi":"openapi.json GET /v1/async_tasks/{task_id}","title":"Retrieve an async task","href":"/reference/retrieve-async-task"}]},{"group":"Blocks","pages":[{"openapi":"patch /v1/blocks/{block_id}/children","title":"Append block children","href":"/reference/patch-block-children"},{"openapi":"get /v1/blocks/{block_id}","title":"Retrieve a block","href":"/reference/retrieve-a-block"},{"openapi":"get /v1/blocks/{block_id}/children","title":"Retrieve block children","href":"/reference/get-block-children"},{"openapi":"patch /v1/blocks/{block_id}","title":"Update a block","href":"/reference/update-a-block"},{"openapi":"delete /v1/blocks/{block_id}","title":"Delete a block","href":"/reference/delete-a-block"},{"title":"Create a meeting note","openapi":"post /v1/blocks/meeting_notes","href":"/reference/create-meeting-note"},{"openapi":"post /v1/blocks/meeting_notes/query","title":"Query meeting notes","href":"/reference/query-meeting-notes"},{"title":"Create a full-page meeting note","openapi":"post /v1/meeting_notes","href":"/reference/create-meeting-note-page"},{"title":"Link a full-page meeting note to a calendar event","openapi":"patch /v1/meeting_notes/{meeting_note_id}","href":"/reference/update-meeting-note-page"}]},{"group":"Pages","pages":[{"openapi":"post /v1/pages","title":"Create a page","href":"/reference/post-page"},{"openapi":"get /v1/pages/{page_id}","title":"Retrieve a page","href":"/reference/retrieve-a-page"},{"openapi":"get /v1/pages/{page_id}/properties/{property_id}","title":"Retrieve a page property item","href":"/reference/retrieve-a-page-property"},{"openapi":"post /v1/pages/{page_id}/move","title":"Move a page","href":"/reference/move-page"},{"group":"Update page","icon":"/icons/nds/pencil.svg","pages":[{"openapi":"patch /v1/pages/{page_id}","title":"Update page","href":"/reference/patch-page"},{"title":"Trash a page","icon":"trash-can","href":"/reference/trash-page"}]},{"group":"Markdown content","icon":"/icons/nds/poundSign.svg","pages":[{"openapi":"get /v1/pages/{page_id}/markdown","title":"Retrieve a page as markdown","href":"/reference/retrieve-page-markdown"},{"openapi":"patch /v1/pages/{page_id}/markdown","title":"Update a page's content as markdown","href":"/reference/update-page-markdown"}]}]},{"group":"Databases","pages":[{"openapi":"post /v1/databases","title":"Create a database","href":"/reference/create-database"},{"openapi":"patch /v1/databases/{database_id}","title":"Update a database","href":"/reference/update-database"},{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","href":"/reference/retrieve-database"}]},{"group":"Data sources","pages":[{"openapi":"post /v1/data_sources","title":"Create a data source","href":"/reference/create-a-data-source"},{"openapi":"get /v1/data_sources/{data_source_id}","title":"Retrieve a data source","href":"/reference/retrieve-a-data-source"},{"title":"List data source templates","openapi":"get /v1/data_sources/{data_source_id}/templates","href":"/reference/list-data-source-templates"},{"group":"Update a data source","icon":"/icons/nds/pencil.svg","pages":[{"openapi":"patch /v1/data_sources/{data_source_id}","title":"Update a data source","href":"/reference/update-a-data-source"},{"title":"Update data source properties","icon":"table-columns","href":"/reference/update-data-source-properties"}]},{"group":"Query a data source","icon":"/icons/nds/clipboard.svg","pages":[{"openapi":"post /v1/data_sources/{data_source_id}/query","title":"Query a data source","href":"/reference/query-a-data-source"},{"title":"Filter data source entries","icon":"filter","href":"/reference/filter-data-source-entries"},{"title":"Sort data source entries","icon":"arrow-down-1-9","href":"/reference/sort-data-source-entries"}]}]},{"group":"Databases (deprecated)","pages":[{"title":"Create a database","openapi":"post /v1/databases","href":"/reference/create-a-database"},{"openapi":"get /v1/databases/{database_id}","title":"Retrieve a database","href":"/reference/retrieve-a-database"},{"openapi":"get /v1/databases","title":null,"href":"/reference/get-databases"},{"group":"Query a database","pages":[{"openapi":"post /v1/databases/{database_id}/query","sidebarTitle":"Overview","title":null,"href":"/reference/post-database-query"},{"title":"Filter database entries","href":"/reference/post-database-query-filter"},{"title":"Sort database entries","href":"/reference/post-database-query-sort"}]},{"group":"Update a database","pages":[{"openapi":"patch /v1/databases/{database_id}","title":"Update a database","href":"/reference/update-a-database"},{"title":"Update database properties (legacy)","sidebarTitle":"Update properties","href":"/reference/update-property-schema-object"}]}]},{"group":"Comments","pages":[{"title":"Create comment","openapi":"post /v1/comments","href":"/reference/create-a-comment"},{"title":"Update comment","openapi":"patch /v1/comments/{comment_id}","href":"/reference/update-a-comment"},{"title":"Delete comment","openapi":"delete /v1/comments/{comment_id}","href":"/reference/delete-a-comment"},{"openapi":"get /v1/comments/{comment_id}","title":"Retrieve a comment","href":"/reference/retrieve-comment"},{"openapi":"get /v1/comments","title":"List comments","href":"/reference/list-comments"}]},{"group":"Views","pages":[{"openapi":"post /v1/views","title":"Create a view","href":"/reference/create-view"},{"openapi":"get /v1/views/{view_id}","title":"Retrieve a view","href":"/reference/retrieve-a-view"},{"openapi":"patch /v1/views/{view_id}","title":"Update a view","href":"/reference/update-a-view"},{"openapi":"delete /v1/views/{view_id}","title":"Delete a view","href":"/reference/delete-view"},{"openapi":"get /v1/views","title":"List views","href":"/reference/list-views"},{"group":"View queries","icon":"/icons/nds/clipboard.svg","pages":[{"openapi":"post /v1/views/{view_id}/queries","title":"Create a view query","href":"/reference/create-view-query"},{"openapi":"get /v1/views/{view_id}/queries/{query_id}","title":"Get view query results","href":"/reference/get-view-query-results"},{"openapi":"delete /v1/views/{view_id}/queries/{query_id}","title":"Delete a view query","href":"/reference/delete-view-query"}]}]},{"group":"File Uploads","pages":[{"openapi":"post /v1/file_uploads","title":"Create a file upload","href":"/reference/create-file"},{"title":"Send a file upload","openapi":"post /v1/file_uploads/{file_upload_id}/send","sidebarTitle":"Send a file upload","href":"/reference/upload-file"},{"title":"Complete a file upload","openapi":"post /v1/file_uploads/{file_upload_id}/complete","href":"/reference/complete-file-upload"},{"openapi":"get /v1/file_uploads/{file_upload_id}","title":"Retrieve a file upload","href":"/reference/retrieve-file-upload"},{"openapi":"get /v1/file_uploads","title":"List file uploads","href":"/reference/list-file-uploads"}]},{"group":"Search","pages":[{"group":"Search by title","icon":"/icons/nds/magnifyingGlass.svg","pages":[{"openapi":"post /v1/search","title":"Search by title","href":"/reference/post-search"}]},{"title":"Search optimizations and limitations","icon":"bolt","href":"/reference/search-optimizations-and-limitations"}]},{"group":"Users","pages":[{"openapi":"get /v1/users","title":"List all users","href":"/reference/get-users"},{"openapi":"get /v1/users/{user_id}","title":"Retrieve a user","href":"/reference/get-user"},{"openapi":"get /v1/users/me","title":"Retrieve your token's bot user","href":"/reference/get-self"}]},{"group":"Custom emojis","pages":[{"openapi":"get /v1/custom_emojis","title":"List custom emojis","href":"/reference/list-custom-emojis"}]},{"group":"Agents","pages":[{"title":"Query agents","openapi":"post /v1/agents/query","href":"/reference/notion-agent-apis/query-agents"},{"title":"Retrieve an agent","openapi":"get /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/retrieve-agent"},{"title":"Retrieve agent insights","openapi":"get /v1/agents/{agent_id}/insights","href":"/reference/notion-agent-apis/retrieve-agent-insights"},{"title":"Update an agent","openapi":"patch /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/update-agent"},{"title":"Update agent status","openapi":"patch /v1/agents/{agent_id}/status","href":"/reference/notion-agent-apis/update-agent-status"},{"title":"Update an agent credit limit","openapi":"patch /v1/agents/{agent_id}/credit_limit","href":"/reference/notion-agent-apis/update-agent-credit-limit"},{"title":"Delete an agent","description":"Soft-delete a Custom Agent with a personal access token.","openapi":"delete /v1/agents/{agent_id}","href":"/reference/notion-agent-apis/delete-agent"},{"title":"Batch manage agent","openapi":"post /v1/agents/batch","href":"/reference/notion-agent-apis/batch-manage-agent"},{"title":"Create or update a session","description":"Start a session, send a message, submit an action, or stream a session turn.","openapi":"post /v1/sessions","href":"/reference/notion-agent-apis/update-session"},{"title":"Retrieve a session","openapi":"get /v1/sessions/{session_id}","href":"/reference/notion-agent-apis/retrieve-session"},{"title":"Query sessions","openapi":"post /v1/sessions/query","href":"/reference/notion-agent-apis/query-sessions"},{"title":"Query session events","openapi":"post /v1/sessions/{session_id}/events/query","href":"/reference/notion-agent-apis/query-session-events"},{"title":"Cancel a session","openapi":"post /v1/sessions/{session_id}/cancel","href":"/reference/notion-agent-apis/cancel-session"}]},{"group":"Agent Skills","pages":[{"title":"List plugins","openapi":"openapi.json GET /v1/ai/plugins","href":"/reference/agent-skills/list-skills-plugins"},{"title":"Get plugin","openapi":"openapi.json GET /v1/ai/plugins/{id}","href":"/reference/agent-skills/get-plugin-directory"},{"title":"Get skill","openapi":"openapi.json GET /v1/ai/skills/{id}","href":"/reference/agent-skills/get-skill-directory"},{"title":"Upload a skill","openapi":"POST /v1/ai/skills/{id}/upload","href":"/reference/agent-skills/upload-skill"}]}]},{"group":"Webhook events","pages":[{"group":"Pages","pages":[{"title":"Page created","openapi":"openapi.json webhook pageCreated","href":"/reference/webhooks/page-created"},{"title":"Page content updated","openapi":"openapi.json webhook pageContentUpdated","href":"/reference/webhooks/page-content-updated"},{"title":"Page properties updated","openapi":"openapi.json webhook pagePropertiesUpdated","href":"/reference/webhooks/page-properties-updated"},{"title":"Page moved","openapi":"openapi.json webhook pageMoved","href":"/reference/webhooks/page-moved"},{"title":"Page deleted","openapi":"openapi.json webhook pageDeleted","href":"/reference/webhooks/page-deleted"},{"title":"Page undeleted","openapi":"openapi.json webhook pageUndeleted","href":"/reference/webhooks/page-undeleted"},{"title":"Page locked","openapi":"openapi.json webhook pageLocked","href":"/reference/webhooks/page-locked"},{"title":"Page unlocked","openapi":"openapi.json webhook pageUnlocked","href":"/reference/webhooks/page-unlocked"},{"title":"Page transcript deleted","openapi":"openapi.json webhook pageTranscriptionBlockTranscriptDeleted","href":"/reference/webhooks/page-transcription-block-transcript-deleted"}]},{"group":"Databases","pages":[{"title":"Database created","openapi":"openapi.json webhook databaseCreated","href":"/reference/webhooks/database-created"},{"title":"Database content updated","openapi":"openapi.json webhook databaseContentUpdated","href":"/reference/webhooks/database-content-updated"},{"title":"Database schema updated","openapi":"openapi.json webhook databaseSchemaUpdated","href":"/reference/webhooks/database-schema-updated"},{"title":"Database moved","openapi":"openapi.json webhook databaseMoved","href":"/reference/webhooks/database-moved"},{"title":"Database deleted","openapi":"openapi.json webhook databaseDeleted","href":"/reference/webhooks/database-deleted"},{"title":"Database undeleted","openapi":"openapi.json webhook databaseUndeleted","href":"/reference/webhooks/database-undeleted"}]},{"group":"Data sources","pages":[{"title":"Data source created","openapi":"openapi.json webhook dataSourceCreated","href":"/reference/webhooks/data-source-created"},{"title":"Data source content updated","openapi":"openapi.json webhook dataSourceContentUpdated","href":"/reference/webhooks/data-source-content-updated"},{"title":"Data source schema updated","openapi":"openapi.json webhook dataSourceSchemaUpdated","href":"/reference/webhooks/data-source-schema-updated"},{"title":"Data source moved","openapi":"openapi.json webhook dataSourceMoved","href":"/reference/webhooks/data-source-moved"},{"title":"Data source deleted","openapi":"openapi.json webhook dataSourceDeleted","href":"/reference/webhooks/data-source-deleted"},{"title":"Data source undeleted","openapi":"openapi.json webhook dataSourceUndeleted","href":"/reference/webhooks/data-source-undeleted"}]},{"group":"Comments","pages":[{"title":"Comment created","openapi":"openapi.json webhook commentCreated","href":"/reference/webhooks/comment-created"},{"title":"Comment updated","openapi":"openapi.json webhook commentUpdated","href":"/reference/webhooks/comment-updated"},{"title":"Comment deleted","openapi":"openapi.json webhook commentDeleted","href":"/reference/webhooks/comment-deleted"}]},{"group":"File uploads","pages":[{"title":"File upload created","openapi":"openapi.json webhook fileUploadCreated","href":"/reference/webhooks/file-upload-created"},{"title":"File upload completed","openapi":"openapi.json webhook fileUploadCompleted","href":"/reference/webhooks/file-upload-completed"},{"title":"File upload expired","openapi":"openapi.json webhook fileUploadExpired","href":"/reference/webhooks/file-upload-expired"},{"title":"File upload failed","openapi":"openapi.json webhook fileUploadUploadFailed","href":"/reference/webhooks/file-upload-upload-failed"}]},{"group":"Views","pages":[{"title":"View created","openapi":"openapi.json webhook viewCreated","href":"/reference/webhooks/view-created"},{"title":"View updated","openapi":"openapi.json webhook viewUpdated","href":"/reference/webhooks/view-updated"},{"title":"View deleted","openapi":"openapi.json webhook viewDeleted","href":"/reference/webhooks/view-deleted"}]}]}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli/get-started/overview"}]},{"tab":"Workers","pages":[{"title":"Workers","href":"/workers/get-started/overview"}]},{"tab":"Custom blocks","hidden":true,"pages":[{"title":"Custom blocks","href":"/custom-blocks/overview"}]},{"tab":"Admin API","hidden":false,"pages":[{"title":"Admin API","href":"/reference/admin/intro"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/page/changelog"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/page/examples"}]},{"tab":"Prompts","hidden":true,"searchable":true,"pages":[{"title":"Prompts","href":"/prompts/setup"}]},{"tab":"Internal","hidden":true,"pages":[{"title":"Internal","href":"/guides/internal/link-previews/building-a-link-preview"}]},{"tab":"Unreleased APIs","hidden":true,"pages":[{"title":"Unreleased APIs","href":"/reference/unreleased/external-agent-apis/start-external-agent-session"}]}]},"basePath":"","title":"Batch manage agent - Notion Docs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}