Overview

The Prompt Orchestra API is an Express application in saas-ai-api/src/index.ts.

These public docs intentionally cover only the frozen public surface:

• stable: stateless agent runtime
• stable: POST /api/setup/verify
• public beta: stateless agent authoring/workflow/compare/diff/rollback
• public beta: skills, tools, evaluations, and stateless skill/tool preview-diff helpers

The API implementation is broader than that. See Public Boundary for what is excluded from public docs and why.

Public contracts

The TypeScript SDK uses publicRouteContracts in prompt-orchestra-contracts/src/routes.ts for the allowlisted public routes. Each contract declares:

• method
• path
• authMode
• request and response schema

Base URL

There is no global OpenAPI file in-repo. Route behavior is defined by handlers plus the public contract package. Use the same host as your deployed saas-ai-api.

See also

• Public Boundary
• Authentication
• Errors