get personal draft
Only the authenticated user’s draft. Dashboard, CLI and MCP share this same personal draft.
/api/v1/organizations/{organizationId}/prompts/{promptId}/draftAuthorization
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.
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/draft"{ "content": { "messages": [ { "role": "system", "content": "string" } ], "inputType": "user_message", "modelId": "string", "modelRouteId": "string", "temperature": 0, "outputSchema": "string", "customMetrics": [ {} ] }, "revision": 0, "updatedAt": "2019-08-24T14:15:22Z"}restore prompt POST
Uses the selected organization and the authenticated user’s current permissions. Applies the same setup and archive rules as the dashboard.
update personal draft PUT
Compare-and-swap revision. A stale write fails with draft_conflict and preserves existing content. Never silently overwrite another window or tool.