Apply a Zero mutation batch
Runs a Zero protocol mutation batch through the server-side mutators, each mutation inside its own transaction, and returns the protocol response; `schema` and `appID` identify the client's Zero app and are required. Called by zero-cache rather than by integrations: the request must carry the Zero service key and a Clerk session with a synced profile.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Query Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/zero/mutate?schema=string&appID=string"null{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Run a Zero query request
Executes a Zero protocol query batch against the server's registered queries on behalf of the authenticated user and returns the protocol response. Called by zero-cache rather than by integrations: the request must carry the Zero service key and a Clerk session with a synced profile, and a caller without the service key is rejected before Clerk or payload decoding runs.
List the workspace's API keys
Returns every API key issued for the workspace, newest first, with its name, prefix, scopes, and last-used, expiry, and revocation timestamps. The token itself is never returned — it is shown once, at creation. Requires the `api_keys:read` permission in the workspace.