Skip to Content
Docs
API referenceTemplates

Make an existing version the live one

POST
/v1/templates/{alias}/versions/{version}/activate

Rolls back (or forward) to any existing version without publishing new content. Sends using the alias render this version immediately. A key with guardrails cannot activate a version (403 policy_violation, policy_template_activation_not_allowed).

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Path Parameters

alias*string
version*integer

Response Body

Activated.

application/json
  1. response
alias?string
active_version?integer
Example Request
curl -X POST 'https://api.emitd.com/v1/templates/string/versions/0/activate'
Example Response
{  "alias": "string",  "active_version": 0}