digitalocean · yGabriel · Dec 31, 2025 · Dec 31, 2025
diff --git a/specification/resources/registry/examples/curl/registries_create.yml b/specification/resources/registry/examples/curl/registries_create.yml
@@ -3,5 +3,5 @@ source: |-
   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-    -d '{"name": "example", "region": "fra1"}' \
+    -d '{"name": "example", "subscription_tier_slug": "basic", "region": "fra1"}' \
     "https://api.digitalocean.com/v2/registries"
diff --git a/specification/resources/registry/examples/python/registries_create.yml b/specification/resources/registry/examples/python/registries_create.yml
@@ -7,7 +7,8 @@ source: |-
 
   req = {
     "name": "example",
-    "region": "fra1"
+    "region": "fra1",
+    "subscription_tier_slug": "basic"
   }
 
   resp = client.registries.create(body=req)
diff --git a/specification/resources/registry/registries_delete_repositoryManifest.yml b/specification/resources/registry/registries_delete_repositoryManifest.yml
@@ -14,7 +14,7 @@ description: |
   A successful request will receive a 204 status code with no body in response.
   This indicates that the request was processed successfully.
 
-  It is similar to DELETE `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests/$MANIFEST_DIGEST` and exists for backward compatibility.
+  It is similar to DELETE `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests/$MANIFEST_DIGEST`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_delete_repositoryTag.yml b/specification/resources/registry/registries_delete_repositoryTag.yml
@@ -12,7 +12,7 @@ description: |
   `/v2/registry/example/repositories/my%2Frepo/tags/mytag`.
 
   A successful request will receive a 204 status code with no body in response.
-  This indicates that the request was processed successfully. It is similar to DELETE `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags/$TAG` and exists for backward compatibility.
+  This indicates that the request was processed successfully. It is similar to DELETE `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags/$TAG`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_get_options.yml b/specification/resources/registry/registries_get_options.yml
@@ -14,7 +14,7 @@ description: >-
   where your data is stored.
 
   To list the available options, send a GET request to
-  `/v2/registries/options`. This is similar to GET `/v2/registry/options` and exists for backward compatibility.
+  `/v2/registries/options`. This is similar to GET `/v2/registry/options`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_get_subscription.yml b/specification/resources/registry/registries_get_subscription.yml
@@ -4,7 +4,7 @@ summary: "Get Subscription Information"
 
 description: A subscription is automatically created when you configure your
   container registry. To get information about your subscription, send a GET
-  request to `/v2/registries/subscription`. It is similar to GET `/v2/registry/subscription` and exists for backward compatibility.
+  request to `/v2/registries/subscription`. It is similar to GET `/v2/registry/subscription`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_list_repositoriesV2.yml b/specification/resources/registry/registries_list_repositoriesV2.yml
@@ -3,7 +3,7 @@ operationId: registries_list_repositoriesV2
 summary: "List All Container Registry Repositories (V2)"
 
 description: To list all repositories in your container registry, send a GET
-  request to `/v2/registries/$REGISTRY_NAME/repositoriesV2`. It is similar to GET `/v2/registry/$REGISTRY_NAME/repositoriesV2` and exists for backward compatibility.
+  request to `/v2/registries/$REGISTRY_NAME/repositoriesV2`. It is similar to GET `/v2/registry/$REGISTRY_NAME/repositoriesV2`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_list_repositoryManifests.yml b/specification/resources/registry/registries_list_repositoryManifests.yml
@@ -11,7 +11,7 @@ description: |
   `registry.digitalocean.com/example/my/repo`, the path would be
   `/v2/registry/example/repositories/my%2Frepo/digests`.
 
-  It is similar to `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests` and exists for backward compatibility.
+  It is similar to `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests`.
 tags:
   - Container Registries
 

diff --git a/specification/resources/registry/registries_list_repositoryTags.yml b/specification/resources/registry/registries_list_repositoryTags.yml
@@ -11,7 +11,7 @@ description: |
   `registry.digitalocean.com/example/my/repo`, the path would be
   `/v2/registry/example/repositories/my%2Frepo/tags`. 
 
-  It is similar to GET `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags` and exists for backward compatibility.
+  It is similar to GET `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_update_garbageCollection.yml b/specification/resources/registry/registries_update_garbageCollection.yml
@@ -4,7 +4,7 @@ summary: "Update Garbage Collection"
 
 description: To cancel the currently-active garbage collection for a registry,
   send a PUT request to `/v2/registries/$REGISTRY_NAME/garbage-collection/$GC_UUID`
-  and specify one or more of the attributes below. It is similar to PUT `/v2/registries/$REGISTRY_NAME/garbage-collection/$GC_UUID` and exists for backward compatibility.
+  and specify one or more of the attributes below. It is similar to PUT `/v2/registries/$REGISTRY_NAME/garbage-collection/$GC_UUID`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_update_subscription.yml b/specification/resources/registry/registries_update_subscription.yml
@@ -4,7 +4,7 @@ summary: "Update Subscription Tier"
 
 description: After creating your registry, you can switch to a different
   subscription tier to better suit your needs. To do this, send a POST request
-  to `/v2/registries/subscription`. It is similar to POST `/v2/registry/subscription` and exists for backward compatibility.
+  to `/v2/registries/subscription`. It is similar to POST `/v2/registry/subscription`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registries_validate_name.yml b/specification/resources/registry/registries_validate_name.yml
@@ -10,7 +10,7 @@ description: |
   be 204 and contain no body. If the name is already in use, the response will
   be a 409 Conflict. 
 
-  It is similar to `/v2/registry/validate-name` and exists for backward compatibility.
+  It is similar to `/v2/registry/validate-name`.
 
 tags:
   - Container Registries

diff --git a/specification/resources/registry/registry_create.yml b/specification/resources/registry/registry_create.yml
@@ -1,8 +1,11 @@
 operationId: registry_create
 
-summary: Create Container Registry
+deprecated: true
 
+summary: 'Create Container Registry'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   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

diff --git a/specification/resources/registry/registry_delete.yml b/specification/resources/registry/registry_delete.yml
@@ -1,8 +1,12 @@
 operationId: registry_delete
 
-summary: Delete Container Registry
+deprecated: true
 
-description: To delete your container registry, destroying all container image
+summary: 'Delete Container Registry'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To delete your container registry, destroying all container image
   data stored in it, send a DELETE request to `/v2/registry`.
 
   This operation is not compatible with multiple registries in a DO account. You should use `/v2/registries/{registry_name}` instead.

diff --git a/specification/resources/registry/registry_delete_repositoryManifest.yml b/specification/resources/registry/registry_delete_repositoryManifest.yml
@@ -1,8 +1,11 @@
 operationId: registry_delete_repositoryManifest
 
-summary: Delete Container Registry Repository Manifest
+deprecated: true
 
+summary: 'Delete Container Registry Repository Manifest'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   To delete a container repository manifest by digest, send a DELETE request to
   `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests/$MANIFEST_DIGEST`.
 

diff --git a/specification/resources/registry/registry_delete_repositoryTag.yml b/specification/resources/registry/registry_delete_repositoryTag.yml
@@ -1,8 +1,11 @@
 operationId: registry_delete_repositoryTag
 
-summary: Delete Container Registry Repository Tag
+deprecated: true
 
+summary: 'Delete Container Registry Repository Tag'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   To delete a container repository tag, send a DELETE request to
   `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags/$TAG`.
 

diff --git a/specification/resources/registry/registry_get.yml b/specification/resources/registry/registry_get.yml
@@ -1,8 +1,12 @@
 operationId: registry_get
 
-summary: Get Container Registry Information
+deprecated: true
 
-description: To get information about your container registry, send a GET
+summary: 'Get Container Registry Information'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To get information about your container registry, send a GET
   request to `/v2/registry`.
 
   This operation is not compatible with multiple registries in a DO account. You should use `/v2/registries/{registry_name}` instead.

diff --git a/specification/resources/registry/registry_get_dockerCredentials.yml b/specification/resources/registry/registry_get_dockerCredentials.yml
@@ -1,8 +1,11 @@
 operationId: registry_get_dockerCredentials
 
-summary: Get Docker Credentials for Container Registry
+deprecated: true
 
+summary: 'Get Docker Credentials for Container Registry'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   In order to access your container registry with the Docker client or from a
   Kubernetes cluster, you will need to configure authentication. The necessary
   JSON configuration can be retrieved by sending a GET request to

diff --git a/specification/resources/registry/registry_get_garbageCollection.yml b/specification/resources/registry/registry_get_garbageCollection.yml
@@ -1,8 +1,12 @@
 operationId: registry_get_garbageCollection
 
-summary: Get Active Garbage Collection
+deprecated: true
 
-description: To get information about the currently-active garbage collection
+summary: 'Get Active Garbage Collection'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To get information about the currently-active garbage collection
   for a registry, send a GET request to `/v2/registry/$REGISTRY_NAME/garbage-collection`.
 
 tags:

diff --git a/specification/resources/registry/registry_get_options.yml b/specification/resources/registry/registry_get_options.yml
@@ -1,8 +1,11 @@
 operationId: registry_get_options
 
-summary: List Registry Options (Subscription Tiers and Available Regions)
+deprecated: true
+
+summary: 'List Registry Options (Subscription Tiers and Available Regions)'
+description: |
+  **Note: This endpoint is deprecated and may be removed in a future version. There is no alternative.****Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
 
-description: >-
   This endpoint serves to provide additional information as to which option values
   are available when creating a container registry.
 

diff --git a/specification/resources/registry/registry_get_subscription.yml b/specification/resources/registry/registry_get_subscription.yml
@@ -1,8 +1,12 @@
 operationId: registry_get_subscription
 
-summary: Get Subscription Information
+deprecated: true
 
-description: A subscription is automatically created when you configure your
+summary: 'Get Subscription'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  A subscription is automatically created when you configure your
   container registry. To get information about your subscription, send a GET
   request to `/v2/registry/subscription`.
 

diff --git a/specification/resources/registry/registry_list_garbageCollections.yml b/specification/resources/registry/registry_list_garbageCollections.yml
@@ -1,8 +1,12 @@
 operationId: registry_list_garbageCollections
 
-summary: List Garbage Collections
+deprecated: true
 
-description: To get information about past garbage collections for a registry,
+summary: 'List Garbage Collections'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To get information about past garbage collections for a registry,
   send a GET request to `/v2/registry/$REGISTRY_NAME/garbage-collections`.
 
 tags:

diff --git a/specification/resources/registry/registry_list_repositories.yml b/specification/resources/registry/registry_list_repositories.yml
@@ -2,9 +2,10 @@ operationId: registry_list_repositories
 
 deprecated: true
 
-summary: List All Container Registry Repositories
-
+summary: 'List All Container Registry Repositories'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   This endpoint has been deprecated in favor of the _List All Container Registry Repositories [V2]_ endpoint.
 
   To list all repositories in your container registry, send a GET

diff --git a/specification/resources/registry/registry_list_repositoriesV2.yml b/specification/resources/registry/registry_list_repositoriesV2.yml
@@ -1,8 +1,12 @@
 operationId: registry_list_repositoriesV2
 
-summary: List All Container Registry Repositories (V2)
+deprecated: true
 
-description: To list all repositories in your container registry, send a GET
+summary: 'List All Container Registry Repositories (V2)'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To list all repositories in your container registry, send a GET
   request to `/v2/registry/$REGISTRY_NAME/repositoriesV2`.
 
 tags:

diff --git a/specification/resources/registry/registry_list_repositoryManifests.yml b/specification/resources/registry/registry_list_repositoryManifests.yml
@@ -1,8 +1,11 @@
 operationId: registry_list_repositoryManifests
 
-summary: List All Container Registry Repository Manifests
+deprecated: true
 
+summary: 'List All Container Registry Repository Manifests'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   To list all manifests in your container registry repository, send a GET
   request to `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/digests`.
 

diff --git a/specification/resources/registry/registry_list_repositoryTags.yml b/specification/resources/registry/registry_list_repositoryTags.yml
@@ -1,8 +1,11 @@
 operationId: registry_list_repositoryTags
 
-summary: List All Container Registry Repository Tags
+deprecated: true
 
+summary: 'List All Container Registry Repository Tags'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   To list all tags in your container registry repository, send a GET
   request to `/v2/registry/$REGISTRY_NAME/repositories/$REPOSITORY_NAME/tags`.
 

diff --git a/specification/resources/registry/registry_run_garbageCollection.yml b/specification/resources/registry/registry_run_garbageCollection.yml
@@ -1,8 +1,11 @@
 operationId: registry_run_garbageCollection
 
-summary: Start Garbage Collection
+deprecated: true
 
+summary: 'Start Garbage Collection'
 description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   Garbage collection enables users to clear out unreferenced blobs (layer &
   manifest data) after deleting one or more manifests from a repository. If
   there are no unreferenced blobs resulting from the deletion of one or more

diff --git a/specification/resources/registry/registry_update_garbageCollection.yml b/specification/resources/registry/registry_update_garbageCollection.yml
@@ -1,8 +1,12 @@
 operationId: registry_update_garbageCollection
 
-summary: Update Garbage Collection
+deprecated: true
 
-description: To cancel the currently-active garbage collection for a registry,
+summary: 'Update Garbage Collection'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  To cancel the currently-active garbage collection for a registry,
   send a PUT request to `/v2/registry/$REGISTRY_NAME/garbage-collection/$GC_UUID`
   and specify one or more of the attributes below.
 

diff --git a/specification/resources/registry/registry_update_subscription.yml b/specification/resources/registry/registry_update_subscription.yml
@@ -1,8 +1,12 @@
 operationId: registry_update_subscription
 
-summary: Update Subscription Tier
+deprecated: true
 
-description: After creating your registry, you can switch to a different
+summary: 'Update Subscription Tier'
+description: |
+  **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
+  After creating your registry, you can switch to a different
   subscription tier to better suit your needs. To do this, send a POST request
   to `/v2/registry/subscription`.
 

diff --git a/specification/resources/registry/registry_validate_name.yml b/specification/resources/registry/registry_validate_name.yml
@@ -1,8 +1,11 @@
 operationId: registry_validate_name
 
-summary: Validate a Container Registry Name
+deprecated: true
 
+summary: 'Validate a Container Registry Name'
 description: |
+ **Note: This endpoint is deprecated. Please use the `/v2/registries` endpoint instead.**
+
   To validate that a container registry name is available for use, send a POST
   request to `/v2/registry/validate-name`.