Notion API token
Store a Notion internal connection token or personal access token in Alter Vault
| Property | Value |
|---|---|
| Template ID | notion |
| Category | Productivity |
| Credential Type | Bearer Token |
| API host | api.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.
Policy-cataloged operations
Section titled “Policy-cataloged operations”Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.
| Operation ID | Families | Method | Provider path | Notes |
|---|---|---|---|---|
delete_agent | delete | DELETE | /v1/agents/{agent_id} | — |
delete_a_block | delete | DELETE | /v1/blocks/{block_id} | allowed; its secret is never stored in a payload capture |
delete_a_comment | delete | DELETE | /v1/comments/{comment_id} | allowed; its secret is never stored in a payload capture |
delete_view | delete | DELETE | /v1/views/{view_id} | — |
delete_view_query | delete | DELETE | /v1/views/{view_id}/queries/{query_id} | — |
get_agent | read | GET | /v1/agents/{agent_id} | allowed; its secret is never stored in a payload capture |
get_agent_insights | read | GET | /v1/agents/{agent_id}/insights | — |
list_skills_plugins | read | GET | /v1/ai/plugins | — |
get_plugin_directory | read | GET | /v1/ai/plugins/{id} | allowed; its secret is never stored in a payload capture |
get_skill_directory | read | GET | /v1/ai/skills/{id} | allowed; its secret is never stored in a payload capture |
retrieve_async_task | read | GET | /v1/async_tasks/{task_id} | allowed; its secret is never stored in a payload capture |
retrieve_a_block | read | GET | /v1/blocks/{block_id} | allowed; its secret is never stored in a payload capture |
get_block_children | read | GET | /v1/blocks/{block_id}/children | allowed; its secret is never stored in a payload capture |
list_comments | read | GET | /v1/comments | allowed; its secret is never stored in a payload capture |
retrieve_comment | read | GET | /v1/comments/{comment_id} | allowed; its secret is never stored in a payload capture |
list_custom_emojis | read | GET | /v1/custom_emojis | — |
retrieve_a_data_source | read | GET | /v1/data_sources/{data_source_id} | allowed; its secret is never stored in a payload capture |
list_data_source_templates | read | GET | /v1/data_sources/{data_source_id}/templates | — |
retrieve_database | read | GET | /v1/databases/{database_id} | allowed; its secret is never stored in a payload capture |
list_file_uploads | read | GET | /v1/file_uploads | — |
retrieve_file_upload | read | GET | /v1/file_uploads/{file_upload_id} | — |
retrieve_a_page | read | GET | /v1/pages/{page_id} | allowed; its secret is never stored in a payload capture |
retrieve_page_markdown | read | GET | /v1/pages/{page_id}/markdown | allowed; its secret is never stored in a payload capture |
retrieve_a_page_property | read | GET | /v1/pages/{page_id}/properties/{property_id} | allowed; its secret is never stored in a payload capture |
retrieve_session | read | GET | /v1/sessions/{session_id} | — |
get_users | read | GET | /v1/users | — |
get_self | read | GET | /v1/users/me | — |
get_user | read | GET | /v1/users/{user_id} | — |
list_views | read | GET | /v1/views | — |
retrieve_a_view | read | GET | /v1/views/{view_id} | — |
get_view_query_results | read | GET | /v1/views/{view_id}/queries/{query_id} | — |
update_agent | admin, delete, write | PATCH | /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_limit | admin, delete, payment, write | PATCH | /v1/agents/{agent_id}/credit_limit | also 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_status | delete, write | PATCH | /v1/agents/{agent_id}/status | unreadable 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_block | delete, send, write | PATCH | /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_children | send, write | PATCH | /v1/blocks/{block_id}/children | 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.@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_comment | send, write | PATCH | /v1/comments/{comment_id} | allowed; its secret is never stored in a payload capture |
update_database | delete, send, write | PATCH | /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_page | delete, send, write | PATCH | /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_markdown | delete, send, write | PATCH | /v1/pages/{page_id}/markdown | also 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_batch | admin, delete, write | POST | /v1/agents/batch | also 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_agents | read | POST | /v1/agents/query | allowed; its secret is never stored in a payload capture |
upload_skill | write | POST | /v1/ai/skills/{id}/upload | — |
create_meeting_note | send, write | POST | /v1/blocks/meeting_notes | also 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_notes | read | POST | /v1/blocks/meeting_notes/query | — |
create_a_comment | send, write | POST | /v1/comments | allowed; its secret is never stored in a payload capture |
create_a_database | send, write | POST | /v1/data_sources | allowed; its secret is never stored in a payload capture |
post_database_query | read | POST | /v1/data_sources/{data_source_id}/query | allowed; its secret is never stored in a payload capture |
create_database | send, write | POST | /v1/databases | also 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_file | send, write | POST | /v1/file_uploads | unreadable 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_upload | write | POST | /v1/file_uploads/{file_upload_id}/complete | — |
upload_file | write | POST | /v1/file_uploads/{file_upload_id}/send | — |
post_page | send, write | POST | /v1/pages | allowed; its secret is never stored in a payload capture |
post_search | read | POST | /v1/search | allowed; its secret is never stored in a payload capture |
query_sessions | read | POST | /v1/sessions/query | — |
cancel_session | delete | POST | /v1/sessions/{session_id}/cancel | — |
query_session_events | read | POST | /v1/sessions/{session_id}/events/query | allowed; its secret is never stored in a payload capture |
create_view_query | read, write | POST | /v1/views/{view_id}/queries | — |
post_v1_oauth_revoke | admin, delete | POST | /v1/oauth/revoke | refused 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_token | admin, write | POST | /v1/oauth/token | refused 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-user | admin, delete | DELETE | /admin/v1/legal_holds/{legal_hold_id}/users/{user_id} | refused on every connection: no rule or allowance can allow it |
admin/delete-agent | admin, delete | DELETE | /admin/v1/spaces/{space_id}/agents/{agent_id} | refused on every connection: no rule or allowance can allow it |
admin/delete-permission-group | admin, delete | DELETE | /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-member | admin, delete | DELETE | /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-token | admin, delete | DELETE | /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-assignment | admin, delete, payment | DELETE | /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-policy | admin, delete, payment | DELETE | /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-vault | admin, delete | DELETE | /v1/external_agent_stub/{agent_id}/vaults/{vault_id} | served by the provider but absent from its published spec |
undocumented/delete-group | admin, delete | DELETE | /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-member | admin, delete | DELETE | /v1/groups/{group_id}/members/users/{user_id} | served by the provider but absent from its published spec |
admin/list-legal-holds | admin, read | GET | /admin/v1/legal_holds | refused on every connection: no rule or allowance can allow it |
admin/get-legal-hold | admin, read | GET | /admin/v1/legal_holds/{legal_hold_id} | refused on every connection: no rule or allowance can allow it |
admin/list-legal-hold-pages | admin, read | GET | /admin/v1/legal_holds/{legal_hold_id}/spaces/{space_id}/pages | refused on every connection: no rule or allowance can allow it |
admin/list-legal-hold-users | admin, read | GET | /admin/v1/legal_holds/{legal_hold_id}/users | refused on every connection: no rule or allowance can allow it |
admin/list-legal-hold-workspaces | admin, read | GET | /admin/v1/legal_holds/{legal_hold_id}/workspaces | refused on every connection: no rule or allowance can allow it |
admin/list-mcp-client-connections | admin, read | GET | /admin/v1/mcp_client_connections | refused on every connection: no rule or allowance can allow it |
admin/list-spaces | admin, read | GET | /admin/v1/spaces | refused on every connection: no rule or allowance can allow it |
admin/get-workflows-metadata-for-space | admin, read | GET | /admin/v1/spaces/{space_id}/agents | refused on every connection: no rule or allowance can allow it |
admin/get-agents-credit-usage | admin, read | GET | /admin/v1/spaces/{space_id}/agents/credit_usage | refused on every connection: no rule or allowance can allow it |
admin/get-agent-credit-usage | admin, read | GET | /admin/v1/spaces/{space_id}/agents/{agent_id}/credit_usage | refused on every connection: no rule or allowance can allow it |
admin/get-agent-permissions | admin, read | GET | /admin/v1/spaces/{space_id}/agents/{agent_id}/permissions | refused on every connection: no rule or allowance can allow it |
admin/get-space-export-status | admin, read | GET | /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-groups | admin, read | GET | /admin/v1/spaces/{space_id}/groups | refused on every connection: no rule or allowance can allow it |
admin/retrieve-permission-group | admin, read | GET | /admin/v1/spaces/{space_id}/groups/{group_id} | refused on every connection: no rule or allowance can allow it |
admin/list-permission-group-members | admin, read | GET | /admin/v1/spaces/{space_id}/groups/{group_id}/members | refused on every connection: no rule or allowance can allow it |
admin/list-personal-access-tokens | admin, read | GET | /admin/v1/spaces/{space_id}/personal_access_tokens | refused on every connection: no rule or allowance can allow it |
admin/list-credit-access-policies | admin, read | GET | /admin/v1/spaces/{space_id}/policies/credit_access | refused on every connection: no rule or allowance can allow it |
admin/get-credit-access-assignment | admin, read | GET | /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-policy | admin, read | GET | /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-assignments | admin, read | GET | /admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignments | refused on every connection: no rule or allowance can allow it |
admin/list-users | admin, read | GET | /admin/v1/spaces/{space_id}/users | refused on every connection: no rule or allowance can allow it |
admin/list-user-credit-usage | admin, read | GET | /admin/v1/spaces/{space_id}/users/credit_usage | refused on every connection: no rule or allowance can allow it |
admin/list-user-credit-usage-periods | admin, read | GET | /admin/v1/spaces/{space_id}/users/{user_id}/credit_usage | refused on every connection: no rule or allowance can allow it |
undocumented/list-agents | read | GET | /v1/agents | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/list-threads | read | GET | /v1/agents/{agent_id}/threads | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/list-connections | read | GET | /v1/connections | served by the provider but absent from its published spec |
undocumented/get-databases | read | GET | /v1/data_sources | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/export-page | admin, read | GET | /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-eligibility | read | GET | /v1/external/refundEligibility | refused on every connection: no rule or allowance can allow it |
undocumented/list-external-agent-stub-session-events | read | GET | /v1/external_agent_stub/{agent_id}/sessions/{session_id}/events | served by the provider but absent from its published spec |
undocumented/retrieve-group | admin, read | GET | /v1/groups/{group_id} | served by the provider but absent from its published spec |
undocumented/list-group-members | admin, read | GET | /v1/groups/{group_id}/members | served by the provider but absent from its published spec |
undocumented/get-rollout | read | GET | /v1/rollout/{rollout_id} | served by the provider but absent from its published spec |
undocumented/get-security-posture | admin, read | GET | /v1/security_center/posture | served by the provider but absent from its published spec |
undocumented/list-teamspaces | read | GET | /v1/teamspaces | served by the provider but absent from its published spec |
undocumented/get-teamspace | read | GET | /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/listTeamMembership | admin, read | GET | /v1/teamspaces/{team_id}/membership | served by the provider but absent from its published spec |
undocumented/listTeamPermissions | admin, read | GET | /v1/teamspaces/{team_id}/permissions | served by the provider but absent from its published spec |
undocumented/list-thread-messages | read | GET | /v1/threads/{thread_id}/messages | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/list-tools | read | GET | /v1/tools | served by the provider but absent from its published spec |
undocumented/authorize-tools-session | read | GET | /v1/tools/auth | served by the provider but absent from its published spec |
admin/update-legal-hold | admin, write | PATCH | /admin/v1/legal_holds/{legal_hold_id} | refused on every connection: no rule or allowance can allow it |
admin/update-agent-creation-policy | admin, delete, write | PATCH | /admin/v1/spaces/{space_id}/agents/creation_policy | refused 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-agent | admin, delete, payment, write | PATCH | /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-permissions | admin, delete, write | PATCH | /admin/v1/spaces/{space_id}/agents/{agent_id}/permissions | refused 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-status | admin, delete, write | PATCH | /admin/v1/spaces/{space_id}/agents/{agent_id}/status | refused 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-limit | admin, payment, write | PATCH | /admin/v1/spaces/{space_id}/credit_limit | refused on every connection: no rule or allowance can allow it |
admin/update-permission-group | admin, write | PATCH | /admin/v1/spaces/{space_id}/groups/{group_id} | refused on every connection: no rule or allowance can allow it |
admin/update-permission-group-member | admin, write | PATCH | /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-assignment | admin, payment, write | PATCH | /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-policy | admin, payment, write | PATCH | /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-permissions | admin, delete, write | PATCH | /v1/_/pages/{page_id}/permissions | also 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-source | admin, delete, send, write | PATCH | /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-vault | admin, write | PATCH | /v1/external_agent_stub/{agent_id}/vaults/{vault_id} | served by the provider but absent from its published spec |
undocumented/update-group | admin, write | PATCH | /v1/groups/{group_id} | served by the provider but absent from its published spec |
undocumented/update-group-member | admin, write | PATCH | /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-page | write | PATCH | /v1/meeting_notes/{meeting_note_id} | served by the provider but absent from its published spec |
undocumented/update-teamspace | admin, delete, send, write | PATCH | /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-membership | admin, delete, send, write | PATCH | /v1/teamspaces/{team_id}/membership | also 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-permissions | admin, delete, write | PATCH | /v1/teamspaces/{team_id}/permissions | also 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-view | admin, delete, write | PATCH | /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-hold | admin, write | POST | /admin/v1/legal_holds | refused on every connection: no rule or allowance can allow it |
admin/export-legal-hold | admin, read, send, write | POST | /admin/v1/legal_holds/{legal_hold_id}/export | refused on every connection: no rule or allowance can allow it |
admin/release-legal-hold | admin, delete | POST | /admin/v1/legal_holds/{legal_hold_id}/release | refused on every connection: no rule or allowance can allow it |
admin/add-legal-hold-users | admin, write | POST | /admin/v1/legal_holds/{legal_hold_id}/users | refused on every connection: no rule or allowance can allow it |
admin/revoke-user-session | admin, delete | POST | /admin/v1/managed_users/revoke_session | refused on every connection: no rule or allowance can allow it |
admin/revoke-mcp-client-connection | admin, delete | POST | /admin/v1/mcp_client_connections/revoke | refused on every connection: no rule or allowance can allow it |
admin/enqueue-space-export | admin, read, send, write | POST | /admin/v1/spaces/{space_id}/exports | refused on every connection: no rule or allowance can allow it |
admin/create-permission-group | admin, write | POST | /admin/v1/spaces/{space_id}/groups | refused on every connection: no rule or allowance can allow it |
admin/add-permission-group-member | admin, send, write | POST | /admin/v1/spaces/{space_id}/groups/{group_id}/members | refused on every connection: no rule or allowance can allow it |
admin/create-credit-access-policy | admin, payment, write | POST | /admin/v1/spaces/{space_id}/policies/credit_access | refused on every connection: no rule or allowance can allow it |
admin/create-credit-access-assignment | admin, payment, write | POST | /admin/v1/spaces/{space_id}/policies/credit_access/{policy_id}/assignments | refused on every connection: no rule or allowance can allow it |
undocumented/chat-with-agent | admin, delete, payment, read, send, write | POST | /v1/agents/{agent_id}/chat | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/chat-with-agent-stream | admin, delete, payment, read, send, write | POST | /v1/agents/{agent_id}/chatStream | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/query-threads | read | POST | /v1/agents/{agent_id}/threads/query | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
legacy-database-query | read | POST | /v1/databases/{database_id}/query | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/initiate-page-export | admin, read, write | POST | /v1/export | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/external-decagon | admin, read, write | POST | /v1/external/decagon | refused 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-profile | read | POST | /v1/external/userC360Profile | refused on every connection: no rule or allowance can allow it |
undocumented/start-external-agent-stub-session | admin, delete, payment, read, send, write | POST | /v1/external_agent_stub/{agent_id}/sessions | served by the provider but absent from its published spec |
undocumented/send-external-agent-stub-session-message | admin, delete, payment, read, send, write | POST | /v1/external_agent_stub/{agent_id}/sessions/{session_id}/messages | served by the provider but absent from its published spec |
undocumented/send-external-agent-stub-session-message-stream | admin, delete, payment, read, send, write | POST | /v1/external_agent_stub/{agent_id}/sessions/{session_id}/messages/stream | served by the provider but absent from its published spec |
undocumented/create-external-agent-stub-vault | admin, send, write | POST | /v1/external_agent_stub/{agent_id}/vaults | served by the provider but absent from its published spec |
undocumented/create-group | admin, write | POST | /v1/groups | served by the provider but absent from its published spec |
undocumented/add-group-member | admin, send, write | POST | /v1/groups/{group_id}/members | served by the provider but absent from its published spec |
undocumented/create-meeting-note-page | write | POST | /v1/meeting_notes | served by the provider but absent from its published spec |
undocumented/ema-resolve-identity | admin, send, write | POST | /v1/oauth/ema/resolve | refused 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-setup | admin, send, write | POST | /v1/oauth/ema/setup | refused on every connection: no rule or allowance can allow it |
undocumented/ema-resolve-trusted-issuer | read, send | POST | /v1/oauth/ema/trusted-issuer | refused on every connection: no rule or allowance can allow it |
introspect-token | read | POST | /v1/oauth/introspect | refused on every connection: no rule or allowance can allow it |
move-page | admin, delete, send, write | POST | /v1/pages/{page_id}/move | also 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-guest | admin, delete | POST | /v1/pages/{page_id}/remove_guests | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/unshare-page-from-web | admin, delete | POST | /v1/pages/{page_id}/unshare_from_web | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/run-unified-rollout | admin, delete, payment, read, send, write | POST | /v1/rollout/unified | served by the provider but absent from its published spec |
update-session | admin, delete, payment, read, send, write | POST | /v1/sessions | also 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-teamspace | admin, send, write | POST | /v1/teamspaces | 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); 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-thread | admin, delete, payment, read, send, write | POST | /v1/threads/{thread_id}/continue | also 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-message | admin, delete, payment, read, send, write | POST | /v1/threads/{thread_id}/messages | served by the provider but absent from its published spec |
undocumented/query-thread-messages | read | POST | /v1/threads/{thread_id}/messages/query | allowed; its secret is never stored in a payload capture; served by the provider but absent from its published spec |
undocumented/run-tool | admin, delete, payment, read, send, write | POST | /v1/tools/run | 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/run-tool-eval | admin, delete, read, send, write | POST | /v1/tools/run/eval | 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/run-internal-tool | admin, delete, payment, read, send, write | POST | /v1/tools/run/internal | 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/run-tool-by-id | admin, delete, payment, read, send, write | POST | /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-content | admin, write | POST | /v1/users/transfer | served by the provider but absent from its published spec |
create-view | admin, delete, write | POST | /v1/views | 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 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-workspace | read | POST | /v1/workspace/search | served by the provider but absent from its published spec |
admin/update-mcp-client-connection-enterprise-managed-access | admin, delete, write | PUT | /admin/v1/mcp_client_connections/enterprise_managed_access | refused 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-limit | admin, delete, payment, write | PUT | /admin/v1/spaces/{space_id}/agents/{agent_id}/credit_limit | refused 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 |