Merge pull request #22270 from docker/feat/api-oat-audit-logs

feat(api): Add oat tag for audit logs

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

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

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: 2
+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.

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: 1
 ---

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
@@ -20,6 +20,10 @@ servers:
     x-audience: public
     url: https://hub.docker.com
 tags:
+  - name: changelog
+    x-displayName: Changelog
+    description: |
+      See the [Changelog](/reference/api/hub/latest-changelog) for a summary of changes across Docker Hub API versions.
   - name: resources
     x-displayName: Resources
     description: |
@@ -400,6 +404,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.
+
+        <span class="oat"></span>
       operationId: AuditLogs_ListAuditActions
       security: 
         - bearerAuth: []
@@ -489,7 +495,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.
+
+        <span class="oat"></span>
       operationId: AuditLogs_ListAuditLogs
       security:
         - bearerAuth: []
@@ -2992,6 +3001,7 @@ components:
 x-tagGroups:
   - name: General
     tags:
+      - changelog
       - resources
       - rate-limiting
       - authentication