POST/templates/use

Create a page from a template

Creates a page from a template in a specified space. Supply templateId and spaceId; optionally provide parentPageId to nest the new page under an existing page. A 200 response returns the created page.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields

The template and space for the new page, with an optional parent page. templateId and spaceId are required.

parentPageIdstringoptional
Nest the new page under this page.
spaceIdstringrequired
Space to create the new page in.
templateIdstringrequired
The UUID of the template to use.

2 status codes
200Returns the page created from the template.
dataobjectoptional
statusintegeroptional
successbooleanoptional
403Returned when the request is forbidden, the template is not found, or templates are not included in the current licence.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

templateId and spaceId are required UUIDs; parentPageId, if provided, must also be a UUID. A 403 is returned when the request is forbidden, the template is not found, or templates are not included in the current licence.