Sign in
iam

Create a custom role for the organization.

post/orgs/{org_id}/iam/roles

Path parameters

org_idstring required

Request body

descriptionstring nullable
namestring required

Role name. Must be unique within the org. Reserved system names (admin, developer, billing, member, user) are rejected.

Response

Role created

created_atstring date-time required
descriptionstring nullable
idstring required
namestring required
source'system' | 'custom' required

Whether a role is a built-in preset or defined by the organization. system roles are read-only; custom roles can be edited or deleted by an organization admin.

updated_atstring date-time required

Changes

Changed in 2 of the 51 revisions of this API.11