Skip to content

Notion API token

Store a Notion internal connection token or personal access token in Alter Vault

PropertyValue
Template IDnotion
CategoryProductivity
Credential TypeBearer Token
API hostapi.notion.com

Create an internal connection or personal access token in the Notion developer portal. Select only the capabilities and content the application needs. For an internal connection, copy its token from Configuration, then share the required pages through Add connections in the page menu.

In Alter’s developer portal, add a managed secret with the Notion template, paste the token and allow api.notion.com. Save it, then create a system grant or use hosted Connect for an end user’s own token. The token is stored in Vault and injected as Authorization: Bearer; application code uses the grant ID.

On save, Alter verifies the token against /v1/users/me with the pinned version header. A definitive 401 rejects the token; permission, network and service failures remain inconclusive. Raw calls must supply Notion-Version; managed SDK calls supply the pinned 2026-03-11 version automatically.

See managed Notion and the operation reference for both SDKs, CLI calls, approvals and audit. Organization bot tokens for the separate Admin API are unsupported; those routes are refused.

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation IDFamiliesMethodProvider pathNotes
delete_agentdeleteDELETE/v1/agents/{agent_id}—
delete_a_blockdeleteDELETE/v1/blocks/{block_id}allowed; its secret is never stored in a payload capture
delete_a_commentdeleteDELETE/v1/comments/{comment_id}allowed; its secret is never stored in a payload capture
delete_viewdeleteDELETE/v1/views/{view_id}—
delete_view_querydeleteDELETE/v1/views/{view_id}/queries/{query_id}—
get_agentreadGET/v1/agents/{agent_id}allowed; its secret is never stored in a payload capture
get_agent_insightsreadGET/v1/agents/{agent_id}/insights—
list_skills_pluginsreadGET/v1/ai/plugins—
get_plugin_directoryreadGET/v1/ai/plugins/{id}allowed; its secret is never stored in a payload capture
get_skill_directoryreadGET/v1/ai/skills/{id}allowed; its secret is never stored in a payload capture
retrieve_async_taskreadGET/v1/async_tasks/{task_id}allowed; its secret is never stored in a payload capture
retrieve_a_blockreadGET/v1/blocks/{block_id}allowed; its secret is never stored in a payload capture
get_block_childrenreadGET/v1/blocks/{block_id}/childrenallowed; its secret is never stored in a payload capture
list_commentsreadGET/v1/commentsallowed; its secret is never stored in a payload capture
retrieve_commentreadGET/v1/comments/{comment_id}allowed; its secret is never stored in a payload capture
list_custom_emojisreadGET/v1/custom_emojis—
retrieve_a_data_sourcereadGET/v1/data_sources/{data_source_id}allowed; its secret is never stored in a payload capture
list_data_source_templatesreadGET/v1/data_sources/{data_source_id}/templates—
retrieve_databasereadGET/v1/databases/{database_id}allowed; its secret is never stored in a payload capture
list_file_uploadsreadGET/v1/file_uploads—
retrieve_file_uploadreadGET/v1/file_uploads/{file_upload_id}—
retrieve_a_pagereadGET/v1/pages/{page_id}allowed; its secret is never stored in a payload capture
retrieve_page_markdownreadGET/v1/pages/{page_id}/markdownallowed; its secret is never stored in a payload capture
retrieve_a_page_propertyreadGET/v1/pages/{page_id}/properties/{property_id}allowed; its secret is never stored in a payload capture
retrieve_sessionreadGET/v1/sessions/{session_id}—
get_usersreadGET/v1/users—
get_selfreadGET/v1/users/me—
get_userreadGET/v1/users/{user_id}—
list_viewsreadGET/v1/views—
retrieve_a_viewreadGET/v1/views/{view_id}—
get_view_query_resultsreadGET/v1/views/{view_id}/queries/{query_id}—
update_agentadmin, delete, writePATCH/v1/agents/{agent_id}also write when body.name is present or body.description is present or body.model is present or body.is_favorited is present; the family column is the upper bound; base families are admin, delete, write; unreadable or invalid effect inputs are refused when the request condition reads them; family alternatives follow the reviewed predicate {"status”: {"active”: [“write”], “disabled”: [“delete"]}}; allowed; its secret is never stored in a payload capture
update_agent_credit_limitadmin, delete, payment, writePATCH/v1/agents/{agent_id}/credit_limitalso delete when (body.credit_limit is present) and (not (body.credit_limit is one of [null])); the family column is the upper bound; base families are admin, payment, write; unreadable or invalid effect inputs are refused when the request condition reads them
update_agent_statusdelete, writePATCH/v1/agents/{agent_id}/statusunreadable or invalid effect inputs are refused when the request condition reads them; family alternatives follow the reviewed predicate {"status”: {"active”: [“write”], “disabled”: [“delete"]}}
update_a_blockdelete, send, writePATCH/v1/blocks/{block_id}also write when not ((the body contains only keys from [“in_trash”]) and (body.in_trash is one of [true]) and (not (body.in_trash is one of [false]))); also delete when body.in_trash is one of [true]; also send when body.@customEmojiPageIconRequest.custom_emoji.url is present or body.@externalFileRequest.url is present or body.@externalPageIconRequest.external.url is present or body.@mentionRichTextItemRequest.mention.custom_emoji.url is present or body.@textRichTextItemRequest.text.link.url is present or body.@updateMediaContentWithUrlAndCaptionRequest.url is present; also send when body.@partialUserObjectRequest.id is present; the family column is the upper bound; base families are none; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
patch_block_childrensend, writePATCH/v1/blocks/{block_id}/childrenalso send when (body.notifications.mode is one of [“default”]) or (body.notifications.mode is absent); also send when body.@customEmojiPageIconRequest.custom_emoji.url is present or body.@externalFileRequest.url is present or body.@externalPageIconRequest.external.url is present or body.@mediaContentWithUrlAndCaptionRequest.url is present or body.@mentionRichTextItemRequest.mention.custom_emoji.url is present or body.@textRichTextItemRequest.text.link.url is present; the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
update_a_commentsend, writePATCH/v1/comments/{comment_id}allowed; its secret is never stored in a payload capture
update_databasedelete, send, writePATCH/v1/databases/{database_id}also write when not ((the body contains only keys from [“in_trash”]) and (body.in_trash is one of [true]) and (not (body.in_trash is one of [false]))); also send when (body.cover.external.url is present) or (body.icon.external.url is present); also delete when body.in_trash is one of [true]; the family column is the upper bound; base families are none; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
patch_pagedelete, send, writePATCH/v1/pages/{page_id}also write when not ((the body contains only keys from [“in_trash”, “is_archived”, “erase_content”, “notifications”]) and ((body.in_trash is one of [true]) or (body.is_archived is one of [true]) or (body.erase_content is one of [true])) and (not ((body.in_trash is one of [false]) or (body.is_archived is one of [false]) or (body.erase_content is one of [false])))); also delete when (body.in_trash is one of [true]) or (body.is_archived is one of [true]); also delete when body.erase_content is one of [true]; also send when (body.notifications.mode is one of [“default”]) or (body.notifications.mode is absent); also send when body.@customEmojiPageIconRequest.custom_emoji.url is present or body.@externalFileRequest.url is present or body.@externalPageCoverRequest.external.url is present or body.@externalPageIconRequest.external.url is present or body.@mentionRichTextItemRequest.mention.custom_emoji.url is present or body.@pagePropertiesRequest.*.url is present or body.@textRichTextItemRequest.text.link.url is present; the family column is the upper bound; base families are none; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
update_page_markdowndelete, send, writePATCH/v1/pages/{page_id}/markdownalso delete when (body.type is one of [“replace_content”]) and (body.replace_content.allow_deleting_content is one of [true]); also delete when (body.type is one of [“replace_content_range”]) and (body.replace_content_range.allow_deleting_content is one of [true]); also delete when (body.type is one of [“update_content”]) and (body.update_content.allow_deleting_content is one of [true]); also send when ((body.type is one of [“insert_content”]) and (body.insert_content.content is present)) or ((body.type is one of [“replace_content”]) and (body.replace_content.new_str is present)) or ((body.type is one of [“replace_content_range”]) and (body.replace_content_range.content is present)) or ((body.type is one of [“update_content”]) and (body.update_content.content_updates[*].new_str is present)); the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
agent_batchadmin, delete, writePOST/v1/agents/batchalso delete when the reviewed predicate {"any_element”: {"any”: [{"path”: “action”, “values”: [“delete"]}, {"all”: [{"path”: “action”, “values”: [“update_status"]}, {"path”: “fields.status”, “values”: [“disabled"]}]}]}, “array_path”: “body.operations"}; also write when the reviewed predicate {"any_element”: {"all”: [{"path”: “action”, “values”: [“update_status"]}, {"path”: “fields.status”, “values”: [“active"]}]}, “array_path”: “body.operations"}; also write, admin when the reviewed predicate {"any_element”: {"path”: “action”, “values”: [“update_credit_limit"]}, “array_path”: “body.operations"}; also delete when the reviewed predicate {"any_element”: {"all”: [{"path”: “action”, “values”: [“update_credit_limit"]}, {"present_paths”: [“fields.credit_limit"]}, {"not”: {"path”: “fields.credit_limit”, “values”: [null]}}]}, “array_path”: “body.operations"}; the family column is the upper bound; base families are none; unreadable or invalid effect inputs are refused when the request condition reads them
query_agentsreadPOST/v1/agents/queryallowed; its secret is never stored in a payload capture
upload_skillwritePOST/v1/ai/skills/{id}/upload—
create_meeting_notesend, writePOST/v1/blocks/meeting_notesalso send when (body.source.type is one of [“file_upload”]) and (body.parent.page_id is present); the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them
query_meeting_notesreadPOST/v1/blocks/meeting_notes/query—
create_a_commentsend, writePOST/v1/commentsallowed; its secret is never stored in a payload capture
create_a_databasesend, writePOST/v1/data_sourcesallowed; its secret is never stored in a payload capture
post_database_queryreadPOST/v1/data_sources/{data_source_id}/queryallowed; its secret is never stored in a payload capture
create_databasesend, writePOST/v1/databasesalso send when (body.cover.external.url is present) or (body.icon.external.url is present); the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture
create_filesend, writePOST/v1/file_uploadsunreadable or invalid effect inputs are refused when the request condition reads them; family alternatives follow the reviewed predicate {"mode”: {"external_url”: [“write”, “send”], “multi_part”: [“write”], “single_part”: [“write"]}}
complete_file_uploadwritePOST/v1/file_uploads/{file_upload_id}/complete—
upload_filewritePOST/v1/file_uploads/{file_upload_id}/send—
post_pagesend, writePOST/v1/pagesallowed; its secret is never stored in a payload capture
post_searchreadPOST/v1/searchallowed; its secret is never stored in a payload capture
query_sessionsreadPOST/v1/sessions/query—
cancel_sessiondeletePOST/v1/sessions/{session_id}/cancel—
query_session_eventsreadPOST/v1/sessions/{session_id}/events/queryallowed; its secret is never stored in a payload capture
create_view_queryread, writePOST/v1/views/{view_id}/queries—
post_v1_oauth_revokeadmin, deletePOST/v1/oauth/revokerefused by default: hands the caller a provider credential, or revokes the connection’s own (a credential_minting rule can allow it); served by the provider but absent from its published spec
post_v1_oauth_tokenadmin, writePOST/v1/oauth/tokenrefused by default: hands the caller a provider credential, or revokes the connection’s own (a credential_minting rule can allow it); served by the provider but absent from its published spec
admin/remove-legal-hold-useradmin, deleteDELETE/admin/v1/legal_holds/{legal_hold_id}/users/{user_id}refused on every connection: no rule or allowance can allow it
admin/delete-agentadmin, deleteDELETE/admin/v1/spaces/{space_id}/agents/{agent_id}refused on every connection: no rule or allowance can allow it
admin/delete-permission-groupadmin, deleteDELETE/admin/v1/spaces/{space_id}/groups/{group_id}refused on every connection: no rule or allowance can allow it; also admin when query.transfer_to_owner_id is present; the family column is the upper bound; base families are delete, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/remove-permission-group-memberadmin, deleteDELETE/admin/v1/spaces/{space_id}/groups/{group_id}/members/users/{user_id}refused on every connection: no rule or allowance can allow it
admin/revoke-personal-access-tokenadmin, deleteDELETE/admin/v1/spaces/{space_id}/personal_access_tokens/{bot_id}refused on every connection: no rule or allowance can allow it
admin/delete-credit-access-assignmentadmin, delete, paymentDELETE/admin/v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}refused on every connection: no rule or allowance can allow it
admin/delete-credit-access-policyadmin, delete, paymentDELETE/admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}refused on every connection: no rule or allowance can allow it
undocumented/delete-external-agent-stub-vaultadmin, deleteDELETE/v1/external_agent_stub/{agent_id}/vaults/{vault_id}served by the provider but absent from its published spec
undocumented/delete-groupadmin, deleteDELETE/v1/groups/{group_id}also admin when body.transfer_to_owner_id is present; the family column is the upper bound; base families are delete, admin; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/remove-group-memberadmin, deleteDELETE/v1/groups/{group_id}/members/users/{user_id}served by the provider but absent from its published spec
admin/list-legal-holdsadmin, readGET/admin/v1/legal_holdsrefused on every connection: no rule or allowance can allow it
admin/get-legal-holdadmin, readGET/admin/v1/legal_holds/{legal_hold_id}refused on every connection: no rule or allowance can allow it
admin/list-legal-hold-pagesadmin, readGET/admin/v1/legal_holds/{legal_hold_id}/spaces/{space_id}/pagesrefused on every connection: no rule or allowance can allow it
admin/list-legal-hold-usersadmin, readGET/admin/v1/legal_holds/{legal_hold_id}/usersrefused on every connection: no rule or allowance can allow it
admin/list-legal-hold-workspacesadmin, readGET/admin/v1/legal_holds/{legal_hold_id}/workspacesrefused on every connection: no rule or allowance can allow it
admin/list-mcp-client-connectionsadmin, readGET/admin/v1/mcp_client_connectionsrefused on every connection: no rule or allowance can allow it
admin/list-spacesadmin, readGET/admin/v1/spacesrefused on every connection: no rule or allowance can allow it
admin/get-workflows-metadata-for-spaceadmin, readGET/admin/v1/spaces/{space_id}/agentsrefused on every connection: no rule or allowance can allow it
admin/get-agents-credit-usageadmin, readGET/admin/v1/spaces/{space_id}/agents/credit_usagerefused on every connection: no rule or allowance can allow it
admin/get-agent-credit-usageadmin, readGET/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_usagerefused on every connection: no rule or allowance can allow it
admin/get-agent-permissionsadmin, readGET/admin/v1/spaces/{space_id}/agents/{agent_id}/permissionsrefused on every connection: no rule or allowance can allow it
admin/get-space-export-statusadmin, readGET/admin/v1/spaces/{space_id}/exports/{export_job_id}refused on every connection: no rule or allowance can allow it; its secret is never stored in a payload capture
admin/list-permission-groupsadmin, readGET/admin/v1/spaces/{space_id}/groupsrefused on every connection: no rule or allowance can allow it
admin/retrieve-permission-groupadmin, readGET/admin/v1/spaces/{space_id}/groups/{group_id}refused on every connection: no rule or allowance can allow it
admin/list-permission-group-membersadmin, readGET/admin/v1/spaces/{space_id}/groups/{group_id}/membersrefused on every connection: no rule or allowance can allow it
admin/list-personal-access-tokensadmin, readGET/admin/v1/spaces/{space_id}/personal_access_tokensrefused on every connection: no rule or allowance can allow it
admin/list-credit-access-policiesadmin, readGET/admin/v1/spaces/{space_id}/policies/credit_accessrefused on every connection: no rule or allowance can allow it
admin/get-credit-access-assignmentadmin, readGET/admin/v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}refused on every connection: no rule or allowance can allow it
admin/get-credit-access-policyadmin, readGET/admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}refused on every connection: no rule or allowance can allow it
admin/list-credit-access-assignmentsadmin, readGET/admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignmentsrefused on every connection: no rule or allowance can allow it
admin/list-usersadmin, readGET/admin/v1/spaces/{space_id}/usersrefused on every connection: no rule or allowance can allow it
admin/list-user-credit-usageadmin, readGET/admin/v1/spaces/{space_id}/users/credit_usagerefused on every connection: no rule or allowance can allow it
admin/list-user-credit-usage-periodsadmin, readGET/admin/v1/spaces/{space_id}/users/{user_id}/credit_usagerefused on every connection: no rule or allowance can allow it
undocumented/list-agentsreadGET/v1/agentsallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/list-threadsreadGET/v1/agents/{agent_id}/threadsallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/list-connectionsreadGET/v1/connectionsserved by the provider but absent from its published spec
undocumented/get-databasesreadGET/v1/data_sourcesallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/export-pageadmin, readGET/v1/export/{id}allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/external-refund-eligibilityreadGET/v1/external/refundEligibilityrefused on every connection: no rule or allowance can allow it
undocumented/list-external-agent-stub-session-eventsreadGET/v1/external_agent_stub/{agent_id}/sessions/{session_id}/eventsserved by the provider but absent from its published spec
undocumented/retrieve-groupadmin, readGET/v1/groups/{group_id}served by the provider but absent from its published spec
undocumented/list-group-membersadmin, readGET/v1/groups/{group_id}/membersserved by the provider but absent from its published spec
undocumented/get-rolloutreadGET/v1/rollout/{rollout_id}served by the provider but absent from its published spec
undocumented/get-security-postureadmin, readGET/v1/security_center/postureserved by the provider but absent from its published spec
undocumented/list-teamspacesreadGET/v1/teamspacesserved by the provider but absent from its published spec
undocumented/get-teamspacereadGET/v1/teamspaces/{team_id}allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/listTeamMembershipadmin, readGET/v1/teamspaces/{team_id}/membershipserved by the provider but absent from its published spec
undocumented/listTeamPermissionsadmin, readGET/v1/teamspaces/{team_id}/permissionsserved by the provider but absent from its published spec
undocumented/list-thread-messagesreadGET/v1/threads/{thread_id}/messagesallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/list-toolsreadGET/v1/toolsserved by the provider but absent from its published spec
undocumented/authorize-tools-sessionreadGET/v1/tools/authserved by the provider but absent from its published spec
admin/update-legal-holdadmin, writePATCH/admin/v1/legal_holds/{legal_hold_id}refused on every connection: no rule or allowance can allow it
admin/update-agent-creation-policyadmin, delete, writePATCH/admin/v1/spaces/{space_id}/agents/creation_policyrefused on every connection: no rule or allowance can allow it; also admin when body.policy is one of [“all_workspace_members”, “workspace_owners_only”]; also delete when (body.policy is one of [“disabled”]) and (body.disable_existing_agents is one of [true]); the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-agentadmin, delete, payment, writePATCH/admin/v1/spaces/{space_id}/agents/{agent_id}refused on every connection: no rule or allowance can allow it; also admin when body.owner_user_id is present; also delete when body.admin_status is one of [“disabled”]; also delete when ((body.credit_limit_by_workspace_admin is present) and (body.credit_limit_by_workspace_admin is non-null)) or ((body.credit_limit_by_editor is present) and (body.credit_limit_by_editor is non-null)); the family column is the upper bound; base families are admin, payment, write; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-agent-permissionsadmin, delete, writePATCH/admin/v1/spaces/{space_id}/agents/{agent_id}/permissionsrefused on every connection: no rule or allowance can allow it; also admin when body.set[].role is present; also delete when body.remove[] is present; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-agent-statusadmin, delete, writePATCH/admin/v1/spaces/{space_id}/agents/{agent_id}/statusrefused on every connection: no rule or allowance can allow it; also delete when body.admin_status is one of [“disabled”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-workspace-credit-limitadmin, payment, writePATCH/admin/v1/spaces/{space_id}/credit_limitrefused on every connection: no rule or allowance can allow it
admin/update-permission-groupadmin, writePATCH/admin/v1/spaces/{space_id}/groups/{group_id}refused on every connection: no rule or allowance can allow it
admin/update-permission-group-memberadmin, writePATCH/admin/v1/spaces/{space_id}/groups/{group_id}/members/users/{user_id}refused on every connection: no rule or allowance can allow it; also admin when body.role is one of [“owner”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-credit-access-assignmentadmin, payment, writePATCH/admin/v1/spaces/{space_id}/policies/credit_access/assignments/{assignment_id}refused on every connection: no rule or allowance can allow it
admin/update-credit-access-policyadmin, payment, writePATCH/admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}refused on every connection: no rule or allowance can allow it
undocumented/private-update-page-permissionsadmin, delete, writePATCH/v1/_/pages/{page_id}/permissionsalso admin when (body.permissions[*].role is present) or (body.is_restricted is one of [false]); also delete when (body.permissions is one of [[]]) or (body.is_restricted is one of [true]); the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
update-a-data-sourceadmin, delete, send, writePATCH/v1/data_sources/{data_source_id}also write when not ((the body contains only keys from [“in_trash”]) and (body.in_trash is one of [true]) and (not (body.in_trash is one of [false]))); also delete when body.in_trash is one of [true]; also send when body.@customEmojiPageIconRequest.custom_emoji.url is present or body.@externalPageIconRequest.external.url is present or body.@mentionRichTextItemRequest.mention.custom_emoji.url is present or body.@textRichTextItemRequest.text.link.url is present or body.@parentOfDataSourceRequest.database_id is present; also send when body.@partialUserObjectRequest.id is present; also admin when body.parent.database_id is present; also admin, delete when body.parent.database_id is present; the family column is the upper bound; base families are none; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/update-external-agent-stub-vaultadmin, writePATCH/v1/external_agent_stub/{agent_id}/vaults/{vault_id}served by the provider but absent from its published spec
undocumented/update-groupadmin, writePATCH/v1/groups/{group_id}served by the provider but absent from its published spec
undocumented/update-group-memberadmin, writePATCH/v1/groups/{group_id}/members/users/{user_id}also admin when body.role is one of [“owner”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/update-meeting-note-pagewritePATCH/v1/meeting_notes/{meeting_note_id}served by the provider but absent from its published spec
undocumented/update-teamspaceadmin, delete, send, writePATCH/v1/teamspaces/{team_id}also admin when (body.visibility is one of [“default”, “open”]) or (body.settings.allow_members_to_invite_members is one of [true]) or (body.settings.allow_members_to_change_sidebar is one of [true]) or (body.settings.disable_guests is one of [false]) or (body.settings.disable_restricted_members is one of [false]) or (body.settings.disable_invite_link is one of [false]) or (body.settings.disable_public_pages is one of [false]); also send when (body.icon.external.url is present) or (body.icon.custom_emoji.url is present); also delete when (body.settings.disable_guests is one of [true]) or (body.settings.disable_restricted_members is one of [true]) or (body.settings.disable_invite_link is one of [true]) or (body.settings.disable_public_pages is one of [true]); the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/update-team-membershipadmin, delete, send, writePATCH/v1/teamspaces/{team_id}/membershipalso admin when (body.operations[].op is one of [“add”]) or (the reviewed predicate {"any_element”: {"all”: [{"path”: “op”, “values”: [“replace"]}, {"path”: “membership”, “values”: [“owner"]}]}, “array_path”: “body.operations"}); also send when body.operations[].op is one of [“add”]; also delete when body.operations[*].op is one of [“remove”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/update-teamspace-permissionsadmin, delete, writePATCH/v1/teamspaces/{team_id}/permissionsalso admin when body.operations[].role is one of [“can_read”, “can_comment”, “can_edit”, “full_access”]; also delete when body.operations[].role is one of [“none”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
update-a-viewadmin, delete, writePATCH/v1/views/{view_id}also delete when body.configuration.is_form_closed is one of [true]; also admin when body.configuration.submission_permissions is one of [“comment_only”, “reader”, “read_and_write”, “editor”]; also admin when body.configuration.submission_permissions is one of [null]; also delete when body.configuration.submission_permissions is one of [“none”]; also admin when (body.configuration.submission_permissions is present) and ((body.configuration.submission_permissions is one of [“comment_only”, “reader”, “read_and_write”, “editor”]) or (body.configuration.submission_permissions is one of [null])); the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
admin/create-legal-holdadmin, writePOST/admin/v1/legal_holdsrefused on every connection: no rule or allowance can allow it
admin/export-legal-holdadmin, read, send, writePOST/admin/v1/legal_holds/{legal_hold_id}/exportrefused on every connection: no rule or allowance can allow it
admin/release-legal-holdadmin, deletePOST/admin/v1/legal_holds/{legal_hold_id}/releaserefused on every connection: no rule or allowance can allow it
admin/add-legal-hold-usersadmin, writePOST/admin/v1/legal_holds/{legal_hold_id}/usersrefused on every connection: no rule or allowance can allow it
admin/revoke-user-sessionadmin, deletePOST/admin/v1/managed_users/revoke_sessionrefused on every connection: no rule or allowance can allow it
admin/revoke-mcp-client-connectionadmin, deletePOST/admin/v1/mcp_client_connections/revokerefused on every connection: no rule or allowance can allow it
admin/enqueue-space-exportadmin, read, send, writePOST/admin/v1/spaces/{space_id}/exportsrefused on every connection: no rule or allowance can allow it
admin/create-permission-groupadmin, writePOST/admin/v1/spaces/{space_id}/groupsrefused on every connection: no rule or allowance can allow it
admin/add-permission-group-memberadmin, send, writePOST/admin/v1/spaces/{space_id}/groups/{group_id}/membersrefused on every connection: no rule or allowance can allow it
admin/create-credit-access-policyadmin, payment, writePOST/admin/v1/spaces/{space_id}/policies/credit_accessrefused on every connection: no rule or allowance can allow it
admin/create-credit-access-assignmentadmin, payment, writePOST/admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignmentsrefused on every connection: no rule or allowance can allow it
undocumented/chat-with-agentadmin, delete, payment, read, send, writePOST/v1/agents/{agent_id}/chatallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/chat-with-agent-streamadmin, delete, payment, read, send, writePOST/v1/agents/{agent_id}/chatStreamallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/query-threadsreadPOST/v1/agents/{agent_id}/threads/queryallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
legacy-database-queryreadPOST/v1/databases/{database_id}/queryallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/initiate-page-exportadmin, read, writePOST/v1/exportallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/external-decagonadmin, read, writePOST/v1/external/decagonrefused on every connection: no rule or allowance can allow it; also write, admin when body.tool is one of [“optOutNotionAIDataSharing”]; the family column is the upper bound; base families are read; unreadable or invalid effect inputs are refused when the request condition reads them
undocumented/external-user-c360-profilereadPOST/v1/external/userC360Profilerefused on every connection: no rule or allowance can allow it
undocumented/start-external-agent-stub-sessionadmin, delete, payment, read, send, writePOST/v1/external_agent_stub/{agent_id}/sessionsserved by the provider but absent from its published spec
undocumented/send-external-agent-stub-session-messageadmin, delete, payment, read, send, writePOST/v1/external_agent_stub/{agent_id}/sessions/{session_id}/messagesserved by the provider but absent from its published spec
undocumented/send-external-agent-stub-session-message-streamadmin, delete, payment, read, send, writePOST/v1/external_agent_stub/{agent_id}/sessions/{session_id}/messages/streamserved by the provider but absent from its published spec
undocumented/create-external-agent-stub-vaultadmin, send, writePOST/v1/external_agent_stub/{agent_id}/vaultsserved by the provider but absent from its published spec
undocumented/create-groupadmin, writePOST/v1/groupsserved by the provider but absent from its published spec
undocumented/add-group-memberadmin, send, writePOST/v1/groups/{group_id}/membersserved by the provider but absent from its published spec
undocumented/create-meeting-note-pagewritePOST/v1/meeting_notesserved by the provider but absent from its published spec
undocumented/ema-resolve-identityadmin, send, writePOST/v1/oauth/ema/resolverefused by default: hands the caller a provider credential, or revokes the connection’s own (a credential_minting rule can allow it); served by the provider but absent from its published spec
undocumented/ema-complete-platform-setupadmin, send, writePOST/v1/oauth/ema/setuprefused on every connection: no rule or allowance can allow it
undocumented/ema-resolve-trusted-issuerread, sendPOST/v1/oauth/ema/trusted-issuerrefused on every connection: no rule or allowance can allow it
introspect-tokenreadPOST/v1/oauth/introspectrefused on every connection: no rule or allowance can allow it
move-pageadmin, delete, send, writePOST/v1/pages/{page_id}/movealso admin when body.parent.page_id is present or body.parent.data_source_id is present; also admin, delete when body.parent.page_id is present or body.parent.data_source_id is present; the family column is the upper bound; base families are write, send; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/remove-page-guestadmin, deletePOST/v1/pages/{page_id}/remove_guestsallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/unshare-page-from-webadmin, deletePOST/v1/pages/{page_id}/unshare_from_weballowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/run-unified-rolloutadmin, delete, payment, read, send, writePOST/v1/rollout/unifiedserved by the provider but absent from its published spec
update-sessionadmin, delete, payment, read, send, writePOST/v1/sessionsalso read, write, delete, send, payment, admin when body.message is present; also read, write, delete, send, payment, admin when body.continue_from is present; also read, write, delete, send, payment, admin when body.actions[].option_id is one of [“approve”]; also delete when body.actions[].option_id is one of [“reject”]; also admin when body.actions[*].option_id is one of [“approve”]; the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/create-teamspaceadmin, send, writePOST/v1/teamspacesalso admin when (body.visibility is one of [“default”, “open”]) or (body.settings.allow_members_to_invite_members is one of [true]) or (body.settings.allow_members_to_change_sidebar is one of [true]) or (body.settings.disable_guests is one of [false]) or (body.settings.disable_restricted_members is one of [false]) or (body.settings.disable_invite_link is one of [false]) or (body.settings.disable_public_pages is one of [false]); also send when (body.icon.external.url is present) or (body.icon.custom_emoji.url is present); the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/continue-threadadmin, delete, payment, read, send, writePOST/v1/threads/{thread_id}/continuealso admin when body.option_id is one of [“approve”, “use_connection”]; also read, write, delete, send, payment, admin when body.option_id is one of [“approve”, “use_connection”]; also delete when body.option_id is one of [“reject”]; the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/send-thread-messageadmin, delete, payment, read, send, writePOST/v1/threads/{thread_id}/messagesserved by the provider but absent from its published spec
undocumented/query-thread-messagesreadPOST/v1/threads/{thread_id}/messages/queryallowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/run-tooladmin, delete, payment, read, send, writePOST/v1/tools/rununreadable or invalid effect inputs are refused when the request condition reads them; tool selection and its reviewed branch predicates determine the request families; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/run-tool-evaladmin, delete, read, send, writePOST/v1/tools/run/evalunreadable or invalid effect inputs are refused when the request condition reads them; tool selection and its reviewed branch predicates determine the request families; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/run-internal-tooladmin, delete, payment, read, send, writePOST/v1/tools/run/internalunreadable or invalid effect inputs are refused when the request condition reads them; tool selection and its reviewed branch predicates determine the request families; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/run-tool-by-idadmin, delete, payment, read, send, writePOST/v1/tools/{tool_id}unreadable or invalid effect inputs are refused when the request condition reads them; tool selection and its reviewed branch predicates determine the request families; allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec
undocumented/transfer-user-contentadmin, writePOST/v1/users/transferserved by the provider but absent from its published spec
create-viewadmin, delete, writePOST/v1/viewsalso delete when body.configuration.is_form_closed is one of [true]; also admin when body.configuration.submission_permissions is one of [“comment_only”, “reader”, “read_and_write”, “editor”]; also admin when body.configuration.submission_permissions is one of [null]; also admin when (body.configuration.submission_permissions is present) and ((body.configuration.submission_permissions is one of [“comment_only”, “reader”, “read_and_write”, “editor”]) or (body.configuration.submission_permissions is one of [null])); the family column is the upper bound; base families are write; unreadable or invalid effect inputs are refused when the request condition reads them; served by the provider but absent from its published spec
undocumented/search-workspacereadPOST/v1/workspace/searchserved by the provider but absent from its published spec
admin/update-mcp-client-connection-enterprise-managed-accessadmin, delete, writePUT/admin/v1/mcp_client_connections/enterprise_managed_accessrefused on every connection: no rule or allowance can allow it; also delete when body.access is one of [“denied”]; the family column is the upper bound; base families are write, admin; unreadable or invalid effect inputs are refused when the request condition reads them
admin/update-agent-credit-limitadmin, delete, payment, writePUT/admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limitrefused on every connection: no rule or allowance can allow it; also delete when (body.credit_limit is present) and (body.credit_limit is non-null); the family column is the upper bound; base families are admin, payment, write; unreadable or invalid effect inputs are refused when the request condition reads them

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.