Skip to main content
POST
Create a role

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

Sajn-Version
enum<string>

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.

Available options:
2026-09,
2026-10
Idempotency-Key
string

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.

Maximum string length: 255

Body

application/json

Body

Create a workspace role

name
string
required

Role name

Minimum string length: 1
permissions
enum<string>[]

Permission keys to grant. To list valid keys, call GET /api/v1/permissions.

A workspace permission key, e.g. "READ_DOCUMENT" or "SEND_DOCUMENT"

Available options:
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

id
string
required

Role ID. Pass it as roleId when you add or update a member; role names can change.

name
string
required

Role name. Organization administrators can rename it.

isDefault
boolean
required

True for a built-in role, which you can't edit or delete

permissions
enum<string>[]
required

Permission keys granted by this role

A workspace permission key, e.g. "READ_DOCUMENT" or "SEND_DOCUMENT"

Available options:
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
memberCount
number
required

Number of workspace members currently assigned this role

createdAt
string<date-time>
required

When the workspace role was created.

updatedAt
string<date-time>
required

When the workspace role was last updated.