get version
Uses the selected organization and the authenticated user’s current permissions. Applies the same setup and archive rules as the dashboard.
/api/v1/organizations/{organizationId}/prompts/{promptId}/versions/{versionId}Authorization
ManagementOAuth managementUser-based Clerk OAuth. CLI is a public Authorization Code client using S256 PKCE and browser loopback redirect. Hosted MCP uses resource-bound OAuth. Verify issuer, token type, intended audience/resource, scopes, live membership and current role. Do not forward arbitrary OAuth tokens into Convex session JWT auth. OAuth URLs below are placeholders for deployment configuration.
In: header
Scope: management
Path Parameters
Permanent organizationId; selected organization must be authorized for the current user.
Permanent promptId; selected organization must be authorized for the current user.
Permanent versionId; selected organization must be authorized for the current user.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/organizations/string/prompts/string/versions/string"{ "id": "string", "number": 1, "content": { "messages": [ { "role": "system", "content": "string" } ], "inputType": "user_message", "modelId": "string", "modelRouteId": "string", "temperature": 0, "outputSchema": "string", "customMetrics": [ {} ] }, "createdAt": "2019-08-24T14:15:22Z", "createdBy": "string"}save version POST
Save an immutable version from the current user’s exact draft revision. Requires completed setup and an active prompt. No evaluation requirement and no automatic label changes. Idempotent replay returns the original version.
get version coverage GET
Report matching completed evidence, current and last evaluated dataset sizes, and stale/quick-only coverage. A same-count content edit can make evidence stale. Quick coverage ignores changes outside the first 10 cases.