POST
/
api
/
v1
/
roles
Create Role
curl --request POST \
  --url http://localhost:8080/api/v1/roles \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "created_at": "2025-08-28T10:00:00Z",
  "updated_at": "2025-08-28T10:00:00Z",
  "name": "Administrator",
  "permissions": [
    "conversations:read",
    "users:manage"
  ]
}'
{
  "status": "success",
  "data": {
    "id": 1,
    "created_at": "2025-08-28T10:00:00Z",
    "updated_at": "2025-08-28T10:00:00Z",
    "name": "Administrator",
    "permissions": [
      "conversations:read",
      "users:manage"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication using base64 encoded API key and secret. Format: Authorization: Basic <base64(api_key:api_secret)>

Body

application/json

Role configuration

The body is of type object.

Response

200
application/json

Role created successfully

The response is of type object.