Clarify API
Object Access

Revoke object access

Revokes a previously granted access delegation. Requires a paid plan with access delegation enabled. Returns 202 Accepted with an empty body. Requires a user-backed API key; workspace-actor API keys are not supported.

DELETE
/workspaces/{workspace}/objects/{object}/access/{id}

Authorization

apiKey
Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

object*string

The object type this delegation applies to: meeting or message.

id*string

The unique ID of the access delegation.

Query Parameters

silent?boolean

When true, suppresses in-app and Slack notifications for this mutation.

Response Body

application/json

curl -X DELETE "https://example.com/workspaces/string/objects/meeting/access/string"
{}

Grant object access

Grants another user entity-wide access delegation: the same access you have to every record of the given object type. Requires a paid plan with access delegation enabled. Requires a user-backed API key; workspace-actor API keys are not supported.

Create a record access grant

Shares a single record of a shareable object (`list`, `meeting`, or `message`) with a user or the whole workspace at a given access level. Only the record’s owner or a workspace permission admin (lists), the record’s owner (messages), or a participant (meetings) can create grants. Requires a user-backed API key; workspace-actor API keys are not supported.