Skip to content

Document allowed_api_keys in track upload/update request bodies#784

Merged
rickyrombo merged 1 commit intomainfrom
document-allowed-api-keys-in-swagger
May 5, 2026
Merged

Document allowed_api_keys in track upload/update request bodies#784
rickyrombo merged 1 commit intomainfrom
document-allowed-api-keys-in-swagger

Conversation

@rickyrombo
Copy link
Copy Markdown
Contributor

Summary

The track response schema already documents allowed_api_keys, but the create_track_request_body and update_track_request_body schemas in the OpenAPI spec did not include it. The Go request structs (UploadTrackRequest, UpdateTrackRequest in api/v1_track.go) already declare the field with the allowed_api_keys JSON tag, and the PUT/POST handlers already forward the full request body into the entity-manager metadata blob — only the OpenAPI documentation was incomplete.

This adds the field to both request body schemas. Once merged and synced, it'll also fix the rendered SDK / API reference on the docs site.

Test plan

  • Confirm swagger.yaml still parses (e.g. swagger validate or rendering in the docs site)
  • Verify the docs site picks up the new field on the next openapi sync

🤖 Generated with Claude Code

The track response schema already documents allowed_api_keys, but the
create_track_request_body and update_track_request_body schemas were
missing it. The Go request structs already accept and forward the
field — only the OpenAPI documentation was lying about the request
shape.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the OpenAPI v1 specification to fully document the existing allowed_api_keys request field for track creation and updates, aligning the docs with the already-implemented Go request structs and handler behavior.

Changes:

  • Added allowed_api_keys to create_track_request_body schema.
  • Added allowed_api_keys to update_track_request_body schema.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@rickyrombo rickyrombo merged commit 064c1e4 into main May 5, 2026
8 of 9 checks passed
@rickyrombo rickyrombo deleted the document-allowed-api-keys-in-swagger branch May 5, 2026 00:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants