Skip to content

docs(aigw): repoint or unlink api-reference links that leak to the Latest version - #1077

Closed
vrv-panw wants to merge 1 commit into
docs/prisma-airs-updatesfrom
docs/prisma-airs-phase-4-links
Closed

vrv-panw wants to merge 1 commit into
docs/prisma-airs-updatesfrom
docs/prisma-airs-phase-4-links

Conversation

@vrv-panw

Copy link
Copy Markdown
Contributor

Links under aigw/ that pointed at /api-reference/... were resolving against the Latest Portkey-branded version. Nothing flagged them as broken, because the targets are real — they are just in the wrong version. A Prisma AIRS reader clicking an API link silently left the Prisma AIRS docs.

Count goes 122 → 90.

Three classes, handled page by page rather than by bulk prefix:

Class Action Examples
Target exists under aigw/ Repointed inference-api/headers, inference-api/config-object, inference-api/open-api-specification, integrations/libraries/microsoft-semantic-kernel
Target will never exist Card removed / prose unlinked, text kept /api-reference/sdk (no SDK reference in aigw/); Workspaces, Users, Log Exports Admin API groups (dropped from the spec)
Target never carried into aigw/ Unlinked, text kept gateway-for-other-apis, anthropic-transform, a Messages API reference

Incidental fix: aigw/api-reference/inference-api/open-api-specification.mdx frontmatter still redirected readers to https://github.com/Portkey-AI/openapi rather than the PaloAltoNetworks repo.

Not in this PR

The remaining ~90 links all target generated operation pages. Every operation summary in the spec is empty and no operation carries x-mint, so the generated pages have neither titles nor pinned URLs — there is nothing stable to point at yet. Blocked on x-mint.href being set upstream in the spec repo.

Five pre-existing broken links under aigw/ are also left alone (out of slice): inference-api/embeddings ×2, inference-api/batch/create-batch (both in the blocked class above), and aigw/support/contact-us ×2 (no such page was carried into aigw/).

Verification

  • mint validate — green
  • mint broken-links — no new breakage under aigw/

🤖 Generated with Claude Code

Links under aigw/ that pointed at /api-reference/... were resolving against
the Latest Portkey-branded version, so nothing flagged them as broken while a
Prisma AIRS reader silently left the Prisma AIRS docs.

Three classes, handled individually rather than by bulk prefix:

- Targets that exist under aigw/ -- repointed (inference-api/headers,
  inference-api/config-object, inference-api/open-api-specification,
  integrations/libraries/microsoft-semantic-kernel).
- Targets that will never exist -- /api-reference/sdk (no SDK reference is
  carried into aigw) and the Workspaces / Users / Log Exports Admin API groups
  (dropped from the spec). Cards removed, prose unlinked with the text kept.
- Targets never carried into aigw -- gateway-for-other-apis, anthropic-transform,
  a Messages API reference. Unlinked, text kept.

Also fixes open-api-specification.mdx, whose frontmatter still redirected to
https://github.com/Portkey-AI/openapi instead of the PaloAltoNetworks repo.

Roughly 90 links remain. Those all target generated operation pages and are
blocked on x-mint.href being set upstream in the spec.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vrv-panw

Copy link
Copy Markdown
Contributor Author

Superseded by #1079, which lands phases 3, 4 and 5 against main in one PR. Every commit here is included there.

@vrv-panw vrv-panw closed this Sep 15, 2026
@vrv-panw
vrv-panw deleted the docs/prisma-airs-phase-4-links branch September 15, 2026 12:12
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