Create a namespace

1 min

POST

{baseUrl}/idgen/namespaces

Creates a namespace in the caller's tenant's namespaces with its first format version (version 1), a DRAFT unless activate is true. Needs idgen.namespaces.write.

acceptstringGenerated from available response content types

bodyobjectThe namespace and its first version.

201The new namespace.

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.

409NAMESPACE_ALREADY_EXISTS: the name is taken, or was used by a deleted namespace.

422INVALID_FORMAT: the first version is invalid; <code>message</code> lists every violation.

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 POST \
     --url http://localhost:8080/idgen/namespaces \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "name": "",
     "version": {
     "separator": "",
     "segments": [
     {
     "type": ""
     }
     ]
     }
     }'