Issue one grant per recipient under a single scope. Atomic across the batch.
Authorizations
Headers
Workspace identifier
Body
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.
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.
branch, branch_and_children, all_branches ISO8601 expiry. Omit for permanent grants.
Entity ids on the path above starting_entity_id in the shared view, top first. Each is shared individually (the item alone, nothing it links to) together with this grant.