Shared Access Grants
Issue one grant per recipient under a single scope. Atomic across the batch.
POST
Issue one grant per recipient under a single scope. Atomic across the batch.
Authorizations
Headers
Workspace identifier
Body
application/json
Branch the grant unlocks. Use "master" for the base branch.
Project the grant is scoped to
Recipients of the grant. Each entry is an existing user_id, an existing user_group_id, or an email; emails for unknown users trigger an external-role invite.
Entity the view should anchor to for the recipient
CustomView.id from the project-scoped custom-views-2 registry
Capability granted for this scope. Viewer preserves v1 read-only sharing.
Available options:
viewer, writer How far the grants reach from branch_id: that branch alone, it plus every branch descended from it, or every branch in the project.
Available options:
branch, branch_and_children, all_branches ISO8601 expiry. Omit for permanent grants.