Clarify APIRevoke a record access grant
Permanently removes an access grant from a record. Only the record’s owner or a workspace permission admin (lists), the record’s owner (messages), or a participant (meetings) can manage grants. Returns 202 Accepted with an empty body. Requires a user-backed API key; workspace-actor API keys are not supported.
Authorization
apiKey API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.
In: header
Path Parameters
The workspace slug — the {slug} segment of your Clarify workspace URL.
The shareable object the record belongs to: list, meeting, or message.
The unique ID of the shared record.
The unique ID of the grant.
Query Parameters
When true, suppresses in-app and Slack notifications for this mutation.
Response Body
application/json
curl -X DELETE "https://example.com/workspaces/string/objects/list/records/string/access/string"{}List record access grants
Returns every access grant on a single record of a shareable object (`list`, `meeting`, or `message`) as a JSON:API collection. A grant shares the record with a single workspace member or the whole workspace at a given access level. Visible to anyone who can already read the record. Requires a user-backed API key; workspace-actor API keys are not supported.
Update a record access grant
Changes the access level of an existing grant on a record. Only the record’s owner or a workspace permission admin (lists), the record’s owner (messages), or a participant (meetings) can manage grants. Requires a user-backed API key; workspace-actor API keys are not supported.