update dataset case
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}/dataset/cases/{caseId}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 caseId; selected organization must be authorized for the current user.
Header Parameters
Management writes: scoped to OAuth user+client+organization+operation. Store request digest and response for at least 24 hours. Same key/body replays original response, including after completion; different body fails idempotency_conflict. Exception: create_retrieval_key stores a non-secret receipt referencing the created key, never its secret. Same-key/body retries return 409 secret_unavailable with existing key metadata and do not create another key. Evaluation creation must not execute twice.
8 <= length <= 128Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/api/v1/organizations/string/prompts/string/dataset/cases/string" \ -H "Idempotency-Key: stringst" \ -H "Content-Type: application/json" \ -d '{ "revision": 0, "row": { "input": "string" } }'{ "id": "string", "position": 0, "input": "string", "expectedOutput": "string", "inputFormat": "text", "referenceFormat": "text"}import dataset POST
Append by default; replace only when explicitly requested. Validate every row and deduplicate exact input/expectedOutput pairs against existing rows and within the request in first-occurrence order. Reject the entire request if any row is invalid or unique additions exceed capacity. Error details include row errors, currentCount, availableCapacity and requestedAddition. Free capacity 10, Pro 500. Existing rows are never truncated on downgrade.
delete dataset case DELETE
Uses the selected organization and the authenticated user’s current permissions. Applies the same setup and archive rules as the dashboard.