revoke retrieval key
Explicitly revoke a retrieval key. Subsequent server requests fail authorization, including conditional requests. Already fetched content cannot be recalled.
/api/v1/organizations/{organizationId}/prompts/{promptId}/keys/{keyId}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 keyId; 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
curl -X DELETE "https://example.com/api/v1/organizations/string/prompts/string/keys/string"create retrieval key POST
Create an organization-owned read-only key scoped to this prompt. Return its full secret only in the initial 201 response and persist only a cryptographic hash; never store the secret in an idempotency receipt. Within the receipt retention period, a retry with the same idempotency key and body creates no duplicate and returns 409 secret_unavailable with the existing key metadata in error.details.key, without a secret. If the original response was lost, explicitly revoke that key and create a replacement using a new idempotency key. Different-body reuse fails idempotency_conflict. No automatic expiry. Rotation creates a new key, then explicitly revokes the old one.
get billing GET
Uses the selected organization and the authenticated user’s current permissions. Applies the same setup and archive rules as the dashboard.