---
title: "[Public Preview] Create Container Registry"
method: POST
path: "/v2/registries"
tags: ["DigitalOcean-public.v2-new_Container Registries"]
---

# [Public Preview] Create Container Registry

`POST /v2/registries`

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`.

## Request body

- MultiregistryCreate
  - `name` string, 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.

## Response `201`

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

- object
  - `registry` Multiregistry
    - `name` string — 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.
    - `created_at` string, date-time — A time value given in ISO8601 combined date and time format that represents when the registry was created.
    - `region` string — Slug of the region where registry data is stored
    - `storage_usage_bytes` integer — The amount of storage used in the registry in bytes.
    - `storage_usage_bytes_updated_at` string, date-time — The time at which the storage usage was updated. Storage usage is calculated asynchronously, and may not immediately reflect pushes to the registry.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)