Skip to content

feat(api-playground): Deploy saves the loaded document into the specs folder (PUT /api/specs/{filename}, confirm before overwrite); the folder's demo.yaml replaces the example; labels Specs, MiniGraph, Browse; api.playground.specs - #548

Merged
acn-ericlaw merged 1 commit into
mainfrom
feat/api-playground-deploy-specs
Oct 11, 2026

Conversation

@acn-ericlaw

Copy link
Copy Markdown
Contributor

What

  • PUT /api/specs/{filename} (DeploySwaggerFile): writes the text body into the specs folder, 409 for an existing name unless ?overwrite=true, 400 for a bad name or empty body. SpecFiles reads the folder before the bundled example; the property is renamed api.playground.specs.
  • The page: Specs, MiniGraph and Browse labels; a Deploy button with a suggested name, a prompt and a confirm on 409; the Specs list refreshes after a deploy.
  • The example document documents the PUT operation; README, the graph contract guide and CHANGELOG items 3 and 4 updated.

Why

Eric’s review of the MiniGraph integration: the loaded document should be one click from being served by the playground itself, under names and labels that say what they are, and a same-named file must never be replaced without asking.

🤖 Generated with Claude Code

… folder (PUT /api/specs/{filename}, confirm before overwrite); the folder's demo.yaml replaces the example; labels Specs, MiniGraph, Browse; api.playground.specs

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@acn-ericlaw
acn-ericlaw merged commit 26b02a2 into main Oct 11, 2026
6 checks passed
@acn-ericlaw
acn-ericlaw deleted the feat/api-playground-deploy-specs branch October 11, 2026 00:06
acn-ericlaw added a commit that referenced this pull request Oct 11, 2026
…h deleted

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
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.

1 participant