Skip to navigation

Retrieve your token's bot user

Retrieves the bot User associated with the API token provided in the authorization header. The bot will have an owner field with information about the person who authorized the integration.

Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.

Integration capabilities

This endpoint is accessible from by integrations with any level of capabilities. The user object returned will adhere to the limitations of the integration’s capabilities. For more information on integration capabilities, see the capabilities guide.

Headers

Notion-VersionstringRequired

The API version to use for this request. The latest version is <<latestNotionVersion>>.

Response

200
objectstringOptional
idstringOptional
namestringOptional
avatar_urlanyOptional
typestringOptional
botobjectOptional

Errors

400
Bad Request Error