Skip to main content
POST
/
admin
/
roles
Create Role
curl --request POST \
  --url https://api.decodahealth.com/admin/roles \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "userType": "USER"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "createdDate": "2023-11-07T05:31:56Z",
  "updatedDate": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "permissions": [
    "<string>"
  ]
}

Headers

​
TENANT
string
required

The tenant you are making this request on behalf of

​
API-KEY
string
required

Your api key

Body

application/json
​
name
string
required

Role name

​
description
string | null

Optional description of the role

​
userType
enum<string>
default:USER

Role type (ADMIN, PROVIDER, USER)

Available options:
ADMIN,
PROVIDER,
USER

Response

Successful Response

Extended role information including permissions

​
id
string
required

Unique identifier for the role

​
name
string
required

Role name (e.g., 'admin', 'user', 'billing_manager')

​
userType
enum<string>
required

Role type (ADMIN, PROVIDER, USER)

Available options:
ADMIN,
PROVIDER,
USER
​
createdDate
string<date-time> | null

When the role was created

​
updatedDate
string<date-time> | null

When the role was last updated

​
description
string | null

Description of what this role does

​
permissions
string[]

List of permission strings