Revoke an item grant or pending invite
Deletes the grant or, when the id refers to a pending item invite instead, revokes that invite and cancels its queued email. Requires `full` on the item, with the `resources:write` scope for API keys. When neither a grant nor a pending invite matches, the request is not found rather than recording a phantom revocation. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/workspaces/string/items/string/access/string"{ "data": { "id": "string" }}{ "_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}Change the access level on an item grant
Sets a new access level on one existing grant for this item and records an access-updated event. Requires `full` on the item, with the `resources:write` scope for API keys. A grant id that is malformed or does not belong to this item is not found. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
Claim a guest item invite with its token
Exchanges an item invite token for a real guest grant on that item and returns the resolved item with the caller's access level. The caller must be authenticated with a verified email that matches the invited address; a token that is expired, already used, or addressed to someone else is not found.