Skip to content

docs(safari): drop skill/download from public API (reclassified jwt, console-only)#106

Merged
ysyneu merged 1 commit into
mainfrom
docs/safari-skill-download-jwt
Jun 24, 2026
Merged

docs(safari): drop skill/download from public API (reclassified jwt, console-only)#106
ysyneu merged 1 commit into
mainfrom
docs/safari-skill-download-jwt

Conversation

@ysyneu

@ysyneu ysyneu commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

/safari/skill/download is reclassified auth=all → jwt in the registry (fc-pgy #570): it is a console-only binary (application/zip) download used by the AI-SRE Customize UI via the session cookie, with no app_key consumer. (It was the odd one out among the console-only safari ops — attachment/*, artifact/*, feedback/create, app/list are already jwt.)

Remove it from the public surface, mirroring the session/cancel removal (#101):

  • per-module + consolidated OpenAPI specs (en+zh) — path + orphan SkillDownloadRequest schema
  • docs.json navigation (en+zh)
  • api-catalog overview (en+zh): AI SRE 26→25, total 240→239

Reconciliation check (every remaining safari spec path present in nav + both catalogs) passes — none missing. The Customize console keeps working (session cookie = jwt). Companion: go-flashduty + flashduty-cli re-sync drops it from the SDK/cli with no breakage (the only public consumers were broken, unused codegen artifacts).

/safari/skill/download is reclassified auth=all -> jwt in the registry
(fc-pgy #570): it is a console-only binary (application/zip) download used
by the Customize UI via the session cookie, with no app_key consumer. Remove
it from the public OpenAPI specs (per-module + consolidated, en+zh), the
docs.json navigation, and the api-catalog overview (AI SRE 26->25, total
240->239). Mirrors the session/cancel removal (#101).
@ysyneu ysyneu merged commit dff18f3 into main Jun 24, 2026
@mintlify

mintlify Bot commented Jun 24, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
flashduty 🟢 Ready View Preview Jun 24, 2026, 2:29 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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