List data source templates

Use this API to retrieve details of all page templates available for a data source.

The response object contains an array under the templates key. Each element of the array is a JSON object with the following attributes:

KeyData TypeMeaning
idString (UUIDv4 format)The ID of the template.
nameStringThe display name of the template.
is_defaultBooleanWhether that template is the data source's default.

Only templates under the data source identified by the data_source_id in the URL are returned. Also, the bot must have access to the template for it to appear in this API. However, in most cases, as long as the bot is connected to the data source's parent database (check the "Connections" list under the 3-dot menu), this access also extends to all of the child templates.

Templates are also valid Notion pages, so you can retrieve a template's full properties and content using the Retrieve a page API. This also means that opening a template in the Notion app and copying its URL is an alternative way to get its ID.

Language