v8

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

DigitalOcean-public.v2-new_Container Registry

Create Container Registry

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

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/registry

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' required

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

region'nyc3' | 'sfo3' | 'ams3' | 'sgp1' | 'fra1'

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",
    "subscription": {
      "tier": {
        "name": "Basic",
        "slug": "basic",
        "included_repositories": 5,
        "included_storage_bytes": 5368709120,
        "allow_storage_overage": true,
        "included_bandwidth_bytes": 5368709120,
        "monthly_price_in_cents": 500,
        "storage_overage_price_in_cents": 2
      },
      "created_at": "2020-01-23T21:19:12Z",
      "updated_at": "2020-11-05T15:53:24Z"
    }
  }
}