API reference · Gateway
Prompts
A prompt library: versioned prompt templates with {{variable}} placeholders, labels such as production and staging, test cases and analytics. Publish a version, then call the prompt by its slug with a virtual key instead of sending the messages yourself.
- List promptsGET
/v1/prompts - Create a promptPOST
/v1/prompts - Get a promptGET
/v1/prompts/{slug} - Update a promptPUT
/v1/prompts/{slug} - Delete a promptDEL
/v1/prompts/{slug} - Get prompt analyticsGET
/v1/prompts/{slug}/analytics - List a prompt's audit logGET
/v1/prompts/{slug}/audit-log - Run a promptPOST
/v1/prompts/{slug}/completions - List prompt labelsGET
/v1/prompts/{slug}/labels - Set a prompt labelPUT
/v1/prompts/{slug}/labels/{label} - Delete a prompt labelDEL
/v1/prompts/{slug}/labels/{label} - Render a promptPOST
/v1/prompts/{slug}/render - List prompt test casesGET
/v1/prompts/{slug}/test-cases - Create a prompt test casePOST
/v1/prompts/{slug}/test-cases - Delete a prompt test caseDEL
/v1/prompts/{slug}/test-cases/{testCaseId} - Run a prompt's test casesPOST
/v1/prompts/{slug}/test-cases/run - List prompt versionsGET
/v1/prompts/{slug}/versions - Create a prompt versionPOST
/v1/prompts/{slug}/versions - Publish a prompt versionPOST
/v1/prompts/{slug}/versions/{versionNumber}/publish - Roll back to a prompt versionPOST
/v1/prompts/{slug}/versions/{versionNumber}/rollback - Get a prompt versionGET
/v1/prompts/{slug}/versions/{versionRef}