Prompt Library And Versioning

Prompt id pp-abc has versions v1, v2, v3; production should always run v2 until explicitly promoted to v3.

Call POST /v1/prompts/pp-abc/completions with explicit version (e.g., version='v2' or via prompt_id-vN form per docs); do not let 'latest' be implicit. Deploy promotion is an explicit operator action in the dashboard or via API.

Prompt template has {{customer_name}} and {{ticket_id}}; caller sends variables={customer_name:'Acme', ticket_id:42}.

Send variables as a JSON object on the request body; Portkey substitutes {{var}} into the template per docs. Missing keys default per template configuration (or fail closed). Validate types before sending — model rendering of a numeric id may differ from a string.

Template references {{order_id}} but caller omits order_id from variables.

Gateway should fail closed with a clear error naming the missing variable (do not silently send the unrendered template to the upstream model — that makes the model confabulate). Operator should validate required variables client-side before sending.