v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_Container Registries

[Public Preview] Create Container Registry

To create your container registry, send a POST request to /v2/registries.

The name becomes part of the URL for images stored in the registry. For example, if your registry is called example, an image in it will have the URL registry.digitalocean.com/example/image:tag.

post/v2/registries

Request body

namestring required

A globally unique name for the container registry. Must be lowercase and be composed only of numbers, letters and -, up to a limit of 63 characters.

subscription_tier_slug'starter' | 'basic' | 'professional'

The slug of the subscription tier to sign up for. Valid values can be retrieved using the options endpoint.

region'nyc3' | 'sfo3' | 'sfo2' | 'ams3' | 'sgp1' | 'fra1' | 'blr1' | 'syd1'

Slug of the region where registry data is stored. When not provided, a region will be selected.

Example request

{
  "name": "example",
  "subscription_tier_slug": "basic",
  "region": "fra1"
}

Response

The response will be a JSON object with the key registry containing information about your registry.

Example response

{
  "registry": {
    "name": "example",
    "created_at": "2020-03-21T16:02:37Z",
    "region": "fra1",
    "storage_usage_bytes": 29393920,
    "storage_usage_bytes_updated_at": "2020-11-04T21:39:49.530562231Z"
  }
}