Update a role
Renames a role, replaces its permissions, or both. You can’t edit a built-in role. To grant ADMINISTRATOR, you must hold it yourself.
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
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 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
The workspace role ID.
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
Role ID. Pass it as roleId when you add or update a member; role names can change.
Role name. Organization administrators can rename it.
True for a built-in role, which you can't edit or delete
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
When the workspace role was created.
When the workspace role was last updated.

