Publish the draft as the next version
POST/v1/click/templates/:templateId/versions
Creates the next immutable version from the template draft. You decide the level (MAJOR, MINOR or PATCH) and give a reason; both are recorded next to the level the server suggested (see the preview). The first publish is 1.0.0 and must be a MAJOR. A MAJOR that follows an earlier version needs a re-acceptance gate. Answers 409 CLICK_NOTHING_CHANGED when the draft equals the latest version. Deployments serving the same major follow a published MINOR or PATCH automatically; a new major is adopted by moving a deployment.
Request
Responses
- 201
- 400
- 404
- 409
- 422
- 503
The published version
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.
The request is malformed or a field is invalid (CLICK_BAD_REQUEST, or CLICK_VALIDATION_FAILED with details).
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.
The resource does not exist in your organization (CLICK_NOT_FOUND, or a more specific code).
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.
CLICK_NOTHING_CHANGED, CLICK_VERSION_CONFLICT or CLICK_TEMPLATE_ARCHIVED
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.
CLICK_FIRST_PUBLISH_MUST_BE_MAJOR, CLICK_CONSPICUOUSNESS_ACK_REQUIRED, CLICK_REACCEPT_GATE_REQUIRED, CLICK_GATE_NOT_APPLICABLE, CLICK_LINKED_DOCUMENT_UNREACHABLE, CLICK_CONTENT_UNSAFE or CLICK_TEMPLATE_NOT_PUBLISHABLE
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.
Versions are temporarily unavailable; nothing was published
Response Headers
Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.
W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.