Skip to content

Update OpenAPI specs from AAP 2.6 to 2.7#146

Merged
mabashian merged 1 commit intomainfrom
update-openapi-specs-2.7
Apr 17, 2026
Merged

Update OpenAPI specs from AAP 2.6 to 2.7#146
mabashian merged 1 commit intomainfrom
update-openapi-specs-2.7

Conversation

@jameswnl
Copy link
Copy Markdown
Contributor

@jameswnl jameswnl commented Apr 15, 2026

Summary

  • Replace all four OpenAPI spec files with their stable-2.7 versions from ansible-automation-platform/aap-openapi-specs
  • No code changes — the server dynamically reads whatever specs are in data/

Spec changes

File Key changes
controller-schema.json Now native OpenAPI 3.0.3 (was Swagger 2 converted). 394 → 378 paths. ~190 auth properties removed from settings (LDAP/SAML/OIDC moved to Gateway).
gateway-schema.json 126 → 125 paths. use_controller_password removed. Proxy timeout fields renamed (stream_idle_timeout + max_stream_durationidle_timeout).
eda-openapi.json v1.2.0 → v1.3.0. Auth schemes simplified. x-ai-description added to operations.
galaxy-openapi.json Updated to 2.7 version.

Follow-up needed

The sync-specs.yml workflow in ansible-automation-platform/aap-openapi-specs (stable-2.7 branch) still references 2.6/ source paths in .github/spec-sync-config.json. That config needs updating separately to point to root-level spec files.

Closes #144

Test plan

  • npm run build passes
  • All 274 tests pass (npm test)

🤖 Generated with Claude Code


Note

Low Risk
Spec-only updates with no executable code changes; risk is limited to downstream consumers that generate clients/validation from these schemas.

Overview
Updates the bundled OpenAPI specs under data/ to the AAP 2.7 (stable-2.7) versions, with no runtime/server code changes (the app will now serve the updated schemas).

Notable spec deltas include the Controller schema moving to native OpenAPI 3.0.3 with fewer documented paths and many auth-related settings fields removed, Gateway schema path/field adjustments (including proxy timeout renames), EDA spec bump to 1.3.0 with simplified auth and added x-ai-description metadata, and an updated Galaxy/Hub schema for 2.7.

Reviewed by Cursor Bugbot for commit 5b9b26f. Bugbot is set up for automated code reviews on this repo. Configure here.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 15, 2026

Coverage Report

Status Category Percentage Covered / Total
🔵 Lines 85.87% 760 / 885
🔵 Statements 85.41% 785 / 919
🟢 Functions 90.81% (🎯 70%) 168 / 185
🟢 Branches 75.84% (🎯 70%) 405 / 534
File CoverageNo changed files found.
Generated in workflow #406 for commit 5b9b26f by the Vitest Coverage Report Action

@de1987
Copy link
Copy Markdown
Contributor

de1987 commented Apr 16, 2026

@jameswnl fyi you are updating the package-lock.json too
besides that, looks good to me, I'm approving it

@mabashian
Copy link
Copy Markdown
Member

@de1987 yea I think we should remove the package-lock.json changes from this PR unless they prove to be critical to updating the api specs (which I doubt). I'll work on that here shortly

@mabashian mabashian force-pushed the update-openapi-specs-2.7 branch from 36836a9 to 31712e5 Compare April 16, 2026 15:26
Replace all four OpenAPI spec files with their stable-2.7 versions
from ansible-automation-platform/aap-openapi-specs.

Closes #144

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mabashian mabashian force-pushed the update-openapi-specs-2.7 branch from 31712e5 to 5b9b26f Compare April 16, 2026 15:47
@mabashian mabashian merged commit 09d5492 into main Apr 17, 2026
9 checks passed
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.

Impact to MCP server by OpenAPI spec differences between AAP 2.6 and 2.7

3 participants