Skip to main content
POST
Grant Permission
Grants a workspace role to a user — or, when the user already holds one, updates it (upsert). The OWNER role cannot be granted; workspace creation persists it for the owner. Requirements: instructions:publish + workspace OWNER + a verified (claimed) account.

Request

string
required
The workspace id.
string
required
The user id receiving the role.
string
required
EDITOR (author changesets), REVIEWER (decide submitted changesets), or VIEWER (read only).

Response

object
The created or updated permission record.