Skip to content

Central API — sync default template catalogue

POST/tenants/{tenant_id}/office/templates/sync-defaults

Copies the platform default template catalogue into the specified tenant workspace, creating any missing templates as drafts. Existing tenant templates are not overwritten. Use when onboarding a new tenant or resetting a tenant's template library to defaults.

Request

Path parameters

NameTypeRequiredDescription
tenant_idstringYes

The tenant identifier (subdomain slug).

Request body

Content type application/json.

FieldTypeRequiredDescription
overwrite_existingbooleanNo

When true, existing tenant templates with matching names are overwritten by the platform defaults.

Default: false

Example

{
  "overwrite_existing": false
}

Responses

200 Default catalogue synchronised

Content type application/json, object.

FieldTypeRequiredDescription
createdintegerNo

Number of new templates created.

skippedintegerNo

Number of existing templates skipped.

Example

{
  "created": 5,
  "skipped": 2
}

404 Tenant not found

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/tenants/{tenant_id}/office/templates/sync-defaults" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"overwrite_existing": false}'
Loading