Skip to content

Unpublish Template

Stop sharing a template and invalidate its link.

DELETE/api/v1/templates/{template_id}/publish

Requires an API key with the write scope.

The template stays in your workspace. Its share link stops working and it leaves the gallery. Each unpublish is recorded as an audit.template.unpublished event.

Path Parameters#

template_idstringpathrequired
The template id.

Response#

dataobject
Show data
idstring
The template id.
publishedboolean
Always false.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: write
404Template not found: the template does not exist in this workspace

Rate Limit#

  • 120 requests per minute, shared by every write call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (write).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026