Skip to content

Add Decisions API reference and Universal API page - #1098

Merged
vrv-panw merged 3 commits into
mainfrom
docs/decisions-api-reference
Sep 29, 2026
Merged

vrv-panw merged 3 commits into
mainfrom
docs/decisions-api-reference

Conversation

@roh26it

@roh26it roh26it commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Adds api-reference/inference-api/decisions.mdx (openapi: post /decisions).
  • Adds a Decisions nav group after Rerank in both versions that read the Portkey-AI/openapi spec (Latest and Virtual Keys (Deprecated)).
  • Adds product/ai-gateway/decisions-api.mdx and lists it after Responses in the Universal API group. The page has a quick start, question types, and gateway features.
  • Adds the same page for Prisma AIRS at aigw/product/ai-gateway/decisions-api.mdx, with the aigw base URL, auth header, and links. It links to the generated aigw reference page and has no plan-tier box.
  • Adds a Decisions group to the Prisma AIRS Inference API reference nav. aigw/scripts/sync_api_nav.py --apply generated it from Add the Decisions endpoint PaloAltoNetworks/openapi#4, which is merged.
  • Links the Decisions bullet in both universal-api.mdx files to the new page.

The two doc sets wire the API reference in different ways:

  • Portkey pages are stubs. Mintlify fills them from the spec at build time, but it does not create pages for new endpoints, so each new endpoint needs a stub and a nav entry.
  • Prisma AIRS (aigw/) has no stubs. Nav groups carry openapi and name their operations, and Mintlify generates a page for each one. The spec repo owns those groups, and sync_api_nav.py copies them in, so aigw needs no .mdx for the endpoint.

Merge after Portkey-AI/openapi#160. That PR adds the /decisions operation that the Portkey reference page renders. The aigw side is already live in PaloAltoNetworks/openapi.

Test plan

  • docs.json parses, and the new pages occur once in each version
  • aigw/scripts/sync_api_nav.py reports in sync
  • Preview renders the Decisions page under Universal API in Portkey and aigw
  • Preview renders /aigw/api-reference/decisions/create-decisions under Inference > Decisions
  • After Add /v1/decisions endpoint spec openapi#160 merges, the Portkey preview renders the request and response schemas

🤖 Generated with Claude Code

API pages are stubs that pull from the Portkey-AI/openapi spec, so a new endpoint needs its own stub and nav entry to appear.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings September 27, 2026 11:34
@mintlify

mintlify Bot commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
portkey-docs 🟢 Ready View Preview Sep 29, 2026, 6:24 AM

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟢 Approval recommended

No unresolved issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Adds a Decisions API reference stub and navigation entries for the Latest and Virtual Keys versions.

Changes:

  • Adds POST /decisions OpenAPI reference stub.
  • Adds Decisions navigation entries after Rerank.
File Description
docs.json Adds Decisions navigation entries in both versions.
api-reference/​inference-api/​decisions.mdx Defines the Decisions API reference stub.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Add a product page for /v1/decisions in both Portkey and aigw docs, list
it after Responses in the Universal API nav, and link it from the
Universal API endpoint list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings September 28, 2026 20:11
@roh26it roh26it changed the title Add Decisions API reference page Add Decisions API reference and Universal API page Sep 28, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

PaloAltoNetworks/openapi#4 added POST /decisions to the Prisma AIRS spec.
Sync the Inference nav from it, and link the aigw Decisions page to the
generated reference page. Also drop the plan-tier box, which does not
apply to Prisma AIRS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

The Portkey reference depends on the /decisions OpenAPI operation being merged and validated before publishing.

Review effort: Lite
Findings: None

@vrv-panw
vrv-panw merged commit 68aaa40 into main Sep 29, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
staging — 097a282d Deployed Sep 29, 2026 by mintlify[bot]
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.

4 participants