Update a workspace role
Rename a workspace role and/or replace its permission set. Built-in (default) roles cannot be edited. Granting the ADMINISTRATOR permission requires that you already hold it.
Permission required: MANAGE_WORKSPACE_ROLES on the workspace.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
Bearer token for API authentication
Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
255Path Parameters
Body
Body
Update a workspace role
New role name
1Replacement set of permission keys. Omit to leave permissions unchanged.
A workspace permission key, e.g. "READ_DOCUMENT" or "SEND_DOCUMENT"
READ_DOCUMENT, CREATE_DOCUMENT, EDIT_DOCUMENT, DELETE_DOCUMENT, SEND_DOCUMENT, APPROVE_DOCUMENT, EDIT_AFTER_SEND, SEND_WITHOUT_APPROVAL, WITHDRAW_DOCUMENT, VIEW_SAJN_ID, MANAGE_SAJN_ID, VIEW_PRIVATE_DOCUMENT, READ_FILE, CREATE_FILE, DELETE_FILE, CHANGE_DOCUMENT_VISIBILITY, READ_CONTACT, CREATE_CONTACT, DELETE_CONTACT, MANAGE_WORKSPACE_MEMBERS, MANAGE_WORKSPACE_ROLES, MANAGE_WORKSPACE_SETTINGS, MANAGE_FORM, DELETE_FORM, READ_FORM_SUBMISSIONS, CREATE_TEMPLATE, UPDATE_TEMPLATE, DELETE_TEMPLATE, RESTORE_TEMPLATE, PERMANENTLY_DELETE_TEMPLATE, VIEW_PRIVATE_TEMPLATE, CHANGE_TEMPLATE_VISIBILITY, CREATE_TAG, UPDATE_TAG, DELETE_TAG, CREATE_CUSTOM_FIELD, UPDATE_CUSTOM_FIELD, DELETE_CUSTOM_FIELD, UPDATE_FILE, UPDATE_CONTACT, MANAGE_AI_SETTINGS, USE_AI_CHAT, USE_AI_DOCUMENT_GENERATION, USE_AI_TEXT_ENHANCEMENT, READ_DOCUMENT_AUDIT_LOG, PERMANENTLY_DELETE_DOCUMENT, RESTORE_DOCUMENT, FORCE_COMPLETE_DOCUMENT, READ_COMMENT, CREATE_COMMENT, UPDATE_COMMENT, DELETE_COMMENT, IMPORT_CONTACTS, EXPORT_CONTACTS, MANAGE_CONTACT_NOTES, LOCK_TEMPLATE, READ_REPORT, CREATE_REPORT, UPDATE_REPORT, DELETE_REPORT, CREATE_BULK_SEND, CREATE_PRODUCT, UPDATE_PRODUCT, DELETE_PRODUCT, MANAGE_API_TOKENS, MANAGE_WEBHOOKS, AUTHORIZE_OAUTH_APP, MANAGE_DEVELOPER, CREATE_FOLDER, UPDATE_FOLDER, DELETE_FOLDER, LOCK_SECTION, ADMINISTRATOR Response
Workspace role
Workspace role
Immutable role identifier — pass this to addMember
Human-readable role name. Editable by org admins.
True for the role that newly-invited members get by default
Permission keys granted by this role
A workspace permission key, e.g. "READ_DOCUMENT" or "SEND_DOCUMENT"
READ_DOCUMENT, CREATE_DOCUMENT, EDIT_DOCUMENT, DELETE_DOCUMENT, SEND_DOCUMENT, APPROVE_DOCUMENT, EDIT_AFTER_SEND, SEND_WITHOUT_APPROVAL, WITHDRAW_DOCUMENT, VIEW_SAJN_ID, MANAGE_SAJN_ID, VIEW_PRIVATE_DOCUMENT, READ_FILE, CREATE_FILE, DELETE_FILE, CHANGE_DOCUMENT_VISIBILITY, READ_CONTACT, CREATE_CONTACT, DELETE_CONTACT, MANAGE_WORKSPACE_MEMBERS, MANAGE_WORKSPACE_ROLES, MANAGE_WORKSPACE_SETTINGS, MANAGE_FORM, DELETE_FORM, READ_FORM_SUBMISSIONS, CREATE_TEMPLATE, UPDATE_TEMPLATE, DELETE_TEMPLATE, RESTORE_TEMPLATE, PERMANENTLY_DELETE_TEMPLATE, VIEW_PRIVATE_TEMPLATE, CHANGE_TEMPLATE_VISIBILITY, CREATE_TAG, UPDATE_TAG, DELETE_TAG, CREATE_CUSTOM_FIELD, UPDATE_CUSTOM_FIELD, DELETE_CUSTOM_FIELD, UPDATE_FILE, UPDATE_CONTACT, MANAGE_AI_SETTINGS, USE_AI_CHAT, USE_AI_DOCUMENT_GENERATION, USE_AI_TEXT_ENHANCEMENT, READ_DOCUMENT_AUDIT_LOG, PERMANENTLY_DELETE_DOCUMENT, RESTORE_DOCUMENT, FORCE_COMPLETE_DOCUMENT, READ_COMMENT, CREATE_COMMENT, UPDATE_COMMENT, DELETE_COMMENT, IMPORT_CONTACTS, EXPORT_CONTACTS, MANAGE_CONTACT_NOTES, LOCK_TEMPLATE, READ_REPORT, CREATE_REPORT, UPDATE_REPORT, DELETE_REPORT, CREATE_BULK_SEND, CREATE_PRODUCT, UPDATE_PRODUCT, DELETE_PRODUCT, MANAGE_API_TOKENS, MANAGE_WEBHOOKS, AUTHORIZE_OAUTH_APP, MANAGE_DEVELOPER, CREATE_FOLDER, UPDATE_FOLDER, DELETE_FOLDER, LOCK_SECTION, ADMINISTRATOR Number of workspace members currently assigned this role

