Skip to main content
POST
/
v0
/
organizations
/
{organization_id}
/
roles
curl --request POST \
  --url 'https://api.unify.ai/v0/organizations/<organization_id>/roles' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{}'

{
    "id": "integer",
    "name": "string",
    "description": "string | null",
    "organization_id": "integer | null",
    "is_system_role": "boolean",
    "created_at": "string",
    "permissions": "[Any]"
}
Create a custom role for an organization. Only organization owners can create custom roles. :param request_fastapi: FastAPI request object. :param organization_id: Organization ID. :param role_data: Role creation data. :param session: Database session. :return: Created role.

​
Authorizations

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Path Parameters

​
organization_id
integer
required

​
Body

​
name
string
required
​
description
string | null
​
permission_ids
[integer]
default:"[]"
curl --request POST \
  --url 'https://api.unify.ai/v0/organizations/<organization_id>/roles' \
  --header "Authorization: Bearer $UNIFY_KEY"
  --header 'Content-Type: application/json' \
  --data '{}'

{
    "id": "integer",
    "name": "string",
    "description": "string | null",
    "organization_id": "integer | null",
    "is_system_role": "boolean",
    "created_at": "string",
    "permissions": "[Any]"
}