iam

Changed on

Create a custom role for the organization.

post/orgs/{org_id}/iam/roles

Request

  • Base URL
    https://api.timbal.ai
  • URL
    https://api.timbal.ai/orgs/{org_id}/iam/roles
  • Auth
    HTTP bearer

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