Skip to content

Publish office template version

POST/office/templates/{id}/publish

Promotes the current draft version to the published version, making it the active template used by all subsequent render jobs for this template. A previous version snapshot is retained for audit and rollback purposes.

Request

Path parameters

NameTypeRequiredDescription
idintegerYes

The numeric ID of the template to publish.

Request body

Content type application/json.

FieldTypeRequiredDescription
publish_notesstringNo

Optional release notes describing what changed in this version.

Max length: 500

Example

{
  "publish_notes": "Updated footer with 2026 company address. Added payment terms table."
}

Responses

200 Draft version promoted to published; all new render jobs will use this version

Content type application/json, object.

FieldTypeRequiredDescription
published_versionintegerNo

Version number that is now active.

Example

{
  "published_version": 4
}

404 Template not found

409 No unpublished draft version exists to promote

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/office/templates/{id}/publish" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"publish_notes": "Updated footer with 2026 company address. Added payment terms table."}'
Loading