Get a namespace

1 min

GET

{baseUrl}/idgen/namespaces/{name}

The namespace and its current version. Needs idgen.namespaces.read. Before a tenant's first ID request for a templated name it answers 404 with details.templateExists = "true".

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

acceptstringGenerated from available response content types

200The namespace.

400INVALID_REQUEST: a malformed path, query or body value.

401UNAUTHENTICATED: missing, expired or invalid credentials.

403FORBIDDEN: the caller lacks the <code>idgen.namespaces.read</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 GET \
     --url http://localhost:8080/idgen/namespaces/{name} \
     --header 'accept: application/json'