Delete a namespace

1 min

DELETE

{baseUrl}/idgen/namespaces/{name}

Soft-deletes the namespace. Its name can never be reused. Needs idgen.namespaces.write.

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

acceptstringGenerated from available response content types

204The namespace 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.namespaces.write</code> permission, or its tenant or site scope does not match.

404NAMESPACE_NOT_FOUND: no such namespace (or it was deleted).

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/namespaces/{name} \
     --header 'accept: application/json'