Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

When organization bot tokens are created, they are assigned some collection of unique scopes. These scopes determine which resources in your organization the bot token can access and how it can access them. Scopes are structured by combining a resource and a capability (for example, legal-hold:read).

List for enterprise scope resources

Scope resourceDescription
legal-holdAbility to manage legal hold data and members
managed-user-sessionAbility to control managed users’ active sessions
workspaceAbility to manage your organization’s workspaces’ data and settings
These scope resources may not be exhaustive. Please consult the API reference you wish to use to see the most accurate scope required to manage the resource you want.

List for enterprise scope capabilities

Scope capabilityDescription
readAbility to view a resource
writeAbility to modify a resource
write-high-impactAbility to irreversibly modify a resource (e.g. delete a resource that cannot be restored)
exportAbility to export a resource