From edc77aab1401d5c2b024673a2ef3e208fdd77831 Mon Sep 17 00:00:00 2001
From: Elizabeth Vo <65384387+ensvo@users.noreply.github.com>
Date: Wed, 11 Sep 2024 15:29:04 +0900
Subject: [PATCH 1/3] api docs for registry show

---
 pages/apis/rest_api/packages/registries.md | 30 ++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/pages/apis/rest_api/packages/registries.md b/pages/apis/rest_api/packages/registries.md
index 33d84ee184..33b264021b 100644
--- a/pages/apis/rest_api/packages/registries.md
+++ b/pages/apis/rest_api/packages/registries.md
@@ -33,3 +33,33 @@ curl -H "Authorization: Bearer $TOKEN" \
 Required scope: `read_registries`
 
 Success response: `200 OK`
+
+## Get a registry
+
+Returns the details for a single registry, looked up by its slug.
+
+```bash
+curl -H "Authorization: Bearer $TOKEN" \
+  -X GET "https://api.buildkite.com/v2/packages/organizations/#{org.slug}/registries/#{registry.slug}"
+```
+
+```json
+{
+  "id": "0191df84-85e4-77aa-83ba-6579084728eb",
+  "graphql_id": "UmVnaXN0cnktLS0wMTkxZGY4NC04NWU0LTc3YWEtODNiYS02NTc5MDg0NzI4ZWI=",
+  "slug": "my-registry",
+  "url": "https://api.buildkite.com/v2/packages/organizations/my-org/registries/my-registry",
+  "web_url": "https://buildkite.com/organizations/my-org/registries/my-registry",
+  "name": "my registry",
+  "ecosystem": "ruby",
+  "description": "registry containing ruby gems",
+  "emoji": null,
+  "color": null,
+  "public": false,
+  "oidc_policy": null
+}
+```
+
+Required scope: `read_registries`
+
+Success response: `200 OK`
\ No newline at end of file

From 77f9ad5665a2d074743247aca4cb03f335266b5d Mon Sep 17 00:00:00 2001
From: Elizabeth Vo <65384387+ensvo@users.noreply.github.com>
Date: Wed, 11 Sep 2024 16:00:51 +0900
Subject: [PATCH 2/3] api docs for registry create

---
 pages/apis/rest_api/packages/registries.md | 56 ++++++++++++++++++++--
 1 file changed, 53 insertions(+), 3 deletions(-)

diff --git a/pages/apis/rest_api/packages/registries.md b/pages/apis/rest_api/packages/registries.md
index 33b264021b..b5c37cbad1 100644
--- a/pages/apis/rest_api/packages/registries.md
+++ b/pages/apis/rest_api/packages/registries.md
@@ -2,6 +2,56 @@
 
 The registries API lets you create and manage registries in your organization.
 
+## Create a registry
+
+```bash
+curl -H "Authorization: Bearer $TOKEN" \
+  -X POST "https://api.buildkite.com/v2/packages/organizations/#{org.slug}/registries" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "my registry",
+    "ecosystem": "ruby"
+    }' 
+```
+
+```json
+{
+  "id": "0191df84-85e4-77aa-83ba-6579084728eb",
+  "graphql_id": "UmVnaXN0cnktLS0wMTkxZGY4NC04NWU0LTc3YWEtODNiYS02NTc5MDg0NzI4ZWI=",
+  "slug": "my-registry",
+  "url": "https://api.buildkite.com/v2/packages/organizations/my-org/registries/my-registry",
+  "web_url": "https://buildkite.com/organizations/my-org/registries/my-registry",
+  "name": "my registry",
+  "ecosystem": "ruby",
+  "description": null,
+  "emoji": null,
+  "color": null,
+  "public": false,
+  "oidc_policy": null
+}
+```
+
+Required [request body properties](/docs/api#request-body-properties):
+
+<table class="responsive-table">
+<tbody>
+  <tr><th><code>name</code></th><td>Name of the new registry.<br><em>Example:</em> <code>"my registry"</code>.</td></tr>
+  <tr><th><code>ecosystem</code></th><td>Registry ecosystem based on the <a href="/docs/packages#get-started">package ecosystem</a> for the new registry.<br><em>Example:</em> <code>"ruby"</code>.</td></tr>
+</tbody>
+</table>
+
+Optional [request body properties](/docs/api#request-body-properties):
+
+<table class="responsive-table">
+  <tbody>
+    <tr><th><code>description</code></th><td>Description of the registry.<br><em>Default value:</em> <code>null</code>.</td></tr>
+  </tbody>
+</table>
+
+Required scope: `create_registries`
+
+Success response: `200 OK`
+
 ## List all registries
 
 Returns a list of an organization's registries.
@@ -21,7 +71,7 @@ curl -H "Authorization: Bearer $TOKEN" \
     "web_url": "https://buildkite.com/organizations/my-org/packages/registries/my-registry",
     "name": "my registry",
     "ecosystem": "ruby",
-    "description": "registry containing ruby gems",
+    "description": null,
     "emoji": null,
     "color": null,
     "public": false,
@@ -52,7 +102,7 @@ curl -H "Authorization: Bearer $TOKEN" \
   "web_url": "https://buildkite.com/organizations/my-org/registries/my-registry",
   "name": "my registry",
   "ecosystem": "ruby",
-  "description": "registry containing ruby gems",
+  "description": null,
   "emoji": null,
   "color": null,
   "public": false,
@@ -62,4 +112,4 @@ curl -H "Authorization: Bearer $TOKEN" \
 
 Required scope: `read_registries`
 
-Success response: `200 OK`
\ No newline at end of file
+Success response: `200 OK`

From 5e4f2b5bd080b9d0f2750c4ad62566dab5df0962 Mon Sep 17 00:00:00 2001
From: Elizabeth Vo <65384387+ensvo@users.noreply.github.com>
Date: Thu, 12 Sep 2024 12:11:14 +0900
Subject: [PATCH 3/3] fix scope naming mistake

---
 pages/apis/rest_api/packages/registries.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pages/apis/rest_api/packages/registries.md b/pages/apis/rest_api/packages/registries.md
index c2ab576c01..265a368004 100644
--- a/pages/apis/rest_api/packages/registries.md
+++ b/pages/apis/rest_api/packages/registries.md
@@ -48,7 +48,7 @@ Optional [request body properties](/docs/api#request-body-properties):
   </tbody>
 </table>
 
-Required scope: `create_registries`
+Required scope: `write_registries`
 
 Success response: `200 OK`