SnozeDevelopers
API referenceItem access

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.

DELETE
/v1/workspaces/{workspaceId}/items/{itemId}/access/{grantId}

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string
itemId*string
grantId*string

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X DELETE 'https://api.snoze.dev/v1/workspaces/string/items/string/access/string'
Example Response
{  "data": {    "id": "string"  }}

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.