v1
latestOpenAPI 3.0.0(C) Copyright IBM Corp. 2016 All Rights Reserved.2026-07-144737155.4 KBCheck the availability of a namespace
This endpoint checks whether a namespace is available in Bluemix and can be used to set up the private Docker images registry for an organization. When a HTTP code 201 Ok is returned, the namespace is already assigned to another organization in Bluemix and cannot be used. When a HTTP code 404 Not found is returned, the namespace can be used for your organization.
Consider the following rules when choosing a namespace for your organization:
- Every organization can have one namespace at a time only
- The namespace must be unique in Bluemix.
- The namespace can be 4-30 characters long.
- The namespace must start with at least one letter or number.
- The namespace can only contain lowercase letters, numbers or underscores (_).
Path parameters
The name of the namespace that you would like to use for your organization and for which you would like to check availability in Bluemix.
Headers
The Bluemix JSON web token that you receive when logging into Bluemix. Run cf oauth-token to retrieve your access token.
The unique ID of your organization space where you want to create or work with your containers. Run cf space <space_name> --guid, where <space_name> is the name of your space, to retrieve your space ID.
Response
OK. The namespace that you chose is already used in Bluemix. Choose another namespace and re-run the API call.