Skip to content

docs: add AI Governance Audit Logs API - #25931

Draft
brefsdal wants to merge 1 commit into
docker:mainfrom
brefsdal:brian/ai-governance-audit-logs-api-docs
Draft

docs: add AI Governance Audit Logs API#25931
brefsdal wants to merge 1 commit into
docker:mainfrom
brefsdal:brian/ai-governance-audit-logs-api-docs

Conversation

@brefsdal

Copy link
Copy Markdown

Description

Adds public documentation for the Docker AI Governance Audit Logs API introduced by docker/data-platform#1418.

  • Adds an OpenAPI 3.0 reference for GET /v2/auditlogs/governance/{org_name}
  • Adds a task-focused guide alongside the existing AI Governance audit-log documentation
  • Documents raw Organization Access Token authentication, supported filters, cursor pagination, response fields, errors, and request limits
  • Links the guide to the existing audit record reference instead of duplicating the event-schema documentation

Release dependency

This PR is a draft because the endpoint is routed only in staging. Keep it unmerged until:

  • The implementation PR is approved and deployed
  • The production api.docker.com route and Envoy policy are configured
  • The OAT View audit logs permission is available in Docker Home
  • The production rate limits are confirmed

Files

Path Description
content/reference/api/ai-governance-audit-logs/api.yaml OpenAPI specification for the list endpoint
content/reference/api/ai-governance-audit-logs/index.md Rendered API reference page
content/manuals/ai/sandboxes/governance/audit/api.md Authentication, filtering, pagination, and rate-limit guide
content/manuals/ai/sandboxes/governance/audit/_index.md Link from the audit-log overview

Validation

  • rumdl fmt and rumdl check: passed
  • Vale 3.17.0: 0 errors, warnings, or suggestions
  • Prettier 3.8.1: passed
  • OpenAPI YAML parsing and endpoint-structure check: passed
  • git diff --check: passed

The local Docker daemon was unavailable, so the full Hugo render and link check are left to PR CI and the deploy preview.

@netlify

netlify Bot commented Aug 25, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 91e7d2d
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a8dd4a1a7c694000894fb09
😎 Deploy Preview https://deploy-preview-25931--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/api Relates to Docker API docs area/ai labels Aug 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai area/api Relates to Docker API docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant