From ce41c7b9fe7f2c9dc03e04c1bb851f9124788716 Mon Sep 17 00:00:00 2001 From: Josh Newman Date: Tue, 18 Mar 2025 00:52:26 -0600 Subject: [PATCH 1/4] Add oat tag for audit logs --- content/reference/api/hub/latest.yaml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/content/reference/api/hub/latest.yaml b/content/reference/api/hub/latest.yaml index 3eaff0a31643..79fe707da883 100644 --- a/content/reference/api/hub/latest.yaml +++ b/content/reference/api/hub/latest.yaml @@ -3,7 +3,7 @@ openapi: 3.0.3 info: title: Docker HUB API - version: beta + version: 2-beta x-logo: url: https://docs.docker.com/assets/images/logo-docker-main.png href: /reference @@ -400,6 +400,8 @@ paths: summary: List audit log actions description: | List audit log actions for a namespace to be used as a filter for querying audit log events. + + operationId: AuditLogs_ListAuditActions security: - bearerAuth: [] @@ -489,7 +491,10 @@ paths: /v2/auditlogs/{account}: get: summary: List audit log events - description: List audit log events for a given namespace. + description: | + List audit log events for a given namespace. + + operationId: AuditLogs_ListAuditLogs security: - bearerAuth: [] From f46fe9efe8736405a7e22a71434111fd47bf1918 Mon Sep 17 00:00:00 2001 From: Josh Newman Date: Tue, 18 Mar 2025 00:52:41 -0600 Subject: [PATCH 2/4] Add changelog with nav improvments --- content/reference/api/hub/deprecated.md | 1 + content/reference/api/hub/dvp.md | 1 + content/reference/api/hub/latest-changelog.md | 19 +++++++++++++++++++ content/reference/api/hub/latest.md | 1 + content/reference/api/hub/latest.yaml | 5 +++++ 5 files changed, 27 insertions(+) create mode 100644 content/reference/api/hub/latest-changelog.md diff --git a/content/reference/api/hub/deprecated.md b/content/reference/api/hub/deprecated.md index 97adcf67ae08..cd32c0d2c049 100644 --- a/content/reference/api/hub/deprecated.md +++ b/content/reference/api/hub/deprecated.md @@ -2,6 +2,7 @@ description: Docker Hub API v1 (deprecated) keywords: kitematic, deprecated title: Docker Hub API v1 (deprecated) +weight: 3 aliases: - /docker-hub/api/deprecated/ --- diff --git a/content/reference/api/hub/dvp.md b/content/reference/api/hub/dvp.md index 1ff43e1dd783..c4cc61554cae 100644 --- a/content/reference/api/hub/dvp.md +++ b/content/reference/api/hub/dvp.md @@ -3,4 +3,5 @@ layout: api description: Reference documentation and Swagger (OpenAPI) specification for the Docker Verified Publisher API. linkTitle: DVP Data API title: Docker Verified Publisher API reference +weight: 4 --- diff --git a/content/reference/api/hub/latest-changelog.md b/content/reference/api/hub/latest-changelog.md new file mode 100644 index 000000000000..fedf6ae6267c --- /dev/null +++ b/content/reference/api/hub/latest-changelog.md @@ -0,0 +1,19 @@ +--- +description: Docker Hub API Changelog +keywords: hub, api, changelog +title: Docker Hub API Changelog +keywords: docker hub, whats new, release notes, api, changelog +weight: 1 +toc_min: 1 +toc_max: 2 +--- + +Here you can learn about the latest changes, new features, bug fixes, and known +issues for Docker Service APIs. + +## 2025-03-18 + +### New + +- Add access to [audit logs](/reference/api/hub/latest/#tag/audit-logs) for org + access tokens. diff --git a/content/reference/api/hub/latest.md b/content/reference/api/hub/latest.md index df2007f59143..906d8c8999a2 100644 --- a/content/reference/api/hub/latest.md +++ b/content/reference/api/hub/latest.md @@ -3,4 +3,5 @@ layout: api description: Reference documentation and OpenAPI specification for the Docker Hub API. title: Docker Hub API reference linkTitle: Docker Hub API +weight: 2 --- diff --git a/content/reference/api/hub/latest.yaml b/content/reference/api/hub/latest.yaml index 79fe707da883..7b3e2fae9fb6 100644 --- a/content/reference/api/hub/latest.yaml +++ b/content/reference/api/hub/latest.yaml @@ -20,6 +20,10 @@ servers: x-audience: public url: https://hub.docker.com tags: + - name: changelog + x-displayName: Changelog + description: | + Check out the [Changelog](/reference/api/hub/latest-changelog)! - name: resources x-displayName: Resources description: | @@ -2997,6 +3001,7 @@ components: x-tagGroups: - name: General tags: + - changelog - resources - rate-limiting - authentication From 0b82b808e1596df214ce45149bca555c5aecfd1b Mon Sep 17 00:00:00 2001 From: Josh Newman Date: Tue, 18 Mar 2025 08:26:01 -0600 Subject: [PATCH 3/4] Reorder nav --- content/reference/api/hub/latest-changelog.md | 2 +- content/reference/api/hub/latest.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/reference/api/hub/latest-changelog.md b/content/reference/api/hub/latest-changelog.md index fedf6ae6267c..030cfc991f4f 100644 --- a/content/reference/api/hub/latest-changelog.md +++ b/content/reference/api/hub/latest-changelog.md @@ -3,7 +3,7 @@ description: Docker Hub API Changelog keywords: hub, api, changelog title: Docker Hub API Changelog keywords: docker hub, whats new, release notes, api, changelog -weight: 1 +weight: 2 toc_min: 1 toc_max: 2 --- diff --git a/content/reference/api/hub/latest.md b/content/reference/api/hub/latest.md index 906d8c8999a2..f70a8cc07eb7 100644 --- a/content/reference/api/hub/latest.md +++ b/content/reference/api/hub/latest.md @@ -3,5 +3,5 @@ layout: api description: Reference documentation and OpenAPI specification for the Docker Hub API. title: Docker Hub API reference linkTitle: Docker Hub API -weight: 2 +weight: 1 --- From db966f255018f13ba7649afb88225b95ed55cbe5 Mon Sep 17 00:00:00 2001 From: Josh Newman Date: Tue, 18 Mar 2025 08:27:46 -0600 Subject: [PATCH 4/4] Update wording for changelog --- content/reference/api/hub/latest.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/reference/api/hub/latest.yaml b/content/reference/api/hub/latest.yaml index 7b3e2fae9fb6..14e787825af7 100644 --- a/content/reference/api/hub/latest.yaml +++ b/content/reference/api/hub/latest.yaml @@ -23,7 +23,7 @@ tags: - name: changelog x-displayName: Changelog description: | - Check out the [Changelog](/reference/api/hub/latest-changelog)! + See the [Changelog](/reference/api/hub/latest-changelog) for a summary of changes across Docker Hub API versions. - name: resources x-displayName: Resources description: |