Delete a version

1 min

DELETE

{baseUrl}/idgen/templates/{name}/versions/{version}

Deletes a DRAFT or SCHEDULED version. Needs idgen.templates.write.

namestringThe template name (<code>^[a-z][a-z0-9._-]{0,63}$</code>).

versioninteger<int32>The version number (from 1).

acceptstringGenerated from available response content types

204The version is deleted.

400INVALID_REQUEST: a malformed path or body value, or an invalid name.

401UNAUTHENTICATED: missing, expired or invalid credentials.

403FORBIDDEN: the caller lacks the <code>idgen.templates.write</code> permission, or its tenant or site scope does not match.

404NAMESPACE_NOT_FOUND or VERSION_NOT_FOUND: no such template or version.

409VERSION_NOT_MUTABLE: the version's state does not allow this change.

500INTERNAL_ERROR: an unexpected failure. Retry once, then report it with the <code>x-request-id</code>.

503AUTH_UNAVAILABLE or BACKEND_UNAVAILABLE (both retryable): retry with backoff.

curl --request DELETE \
     --url http://localhost:8080/idgen/templates/{name}/versions/{version} \
     --header 'accept: application/json'