v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01206322659.2 KB
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