v1
latestOpenAPI 3.0.0(C) Copyright IBM Corp. 2016 All Rights Reserved.2026-07-144737155.4 KBSet a namespace for your private Bluemix registry.
Set up your own Docker images registry in Bluemix by defining a namespace for your organization (corresponding IBM Containers command: cf ic namespace set <namespace>). The namespace is used to generate a unique URL to your private Bluemix registry. In your private registry you store all Docker images that you want to share across your organization. To create a container from an image, you must first push the image to your registry.
The namespace cannot be changed after is has been set. Consider the following rules to choose 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 for your namespace to create your private Docker images registry in Bluemix. You cannot change the name afterward. The namespace can be 4-30 characters long, must start with at least one letter or number, and can only contain lowercase letters, numbers or underscores (_). You can test the availability of your namespace by calling the GET /registry/namespaces/<namespace> endpoint. When a HTTP code 404 Not Found is returned, the namespace is available 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 is successfully set for your organization.