Grant permissions on a workbook to users or teams

POST https://api.sigmacomputing.com/v2/workbooks/{workbookId}/grants

You can use this endpoint to grant specific document permissions on a specific workbook to users or teams.

Usage Notes

• Ensure the workbookId in the path is valid and that the user has rights to modify its permissions.
• Do not set both memberId and teamId in the same grantee object. Instead, choose one based on the target of the grant.

Usage Scenarios

• Team Collaboration: Granting edit permissions to a team for collaborative work on a project.
• External Consultant: Providing view access to an external consultant.

Best Practices

• Validate user and team IDs before submitting them in a request to avoid errors.
• Use the tagId to help manage and revoke grants systematically as project requirements change.