Skip to main content
POST
/
v1
/
decision-roles
Create decision role
curl --request POST \
  --url https://staging.api.us.aptlydone.com/settings/v1/decision-roles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tenantId": "d46619ed-1b12-4e30-ac9a-bb3fdbae2abf",
  "roleName": "Approver"
}
'
{
  "statusCode": 200,
  "timestamp": "2026-01-08T06:33:20.711Z",
  "message": "Success",
  "data": {
    "id": "ad4c5d66-91e2-4370-bfbb-99a7d78cc5f8",
    "tenantId": "dc7ef50f-4912-46b9-9914-eb86a0e1f81d",
    "roleName": "Approver",
    "isDeleted": false
  }
}

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ā€‹
tenantId
string
required

Tenant ID

Example:

"d46619ed-1b12-4e30-ac9a-bb3fdbae2abf"

ā€‹
roleName
string
required

Role name

Maximum string length: 50
Example:

"Approver"

ā€‹
status
enum<string>

Status

Available options:
ACTIVE,
INACTIVE

Response

201 - application/json

Decision role created successfully

ā€‹
statusCode
number
required

HTTP Status code

Example:

200

ā€‹
timestamp
string
required

Timestamp of the response

Example:

"2026-01-08T06:33:20.711Z"

ā€‹
message
string
required

Response message

Example:

"Success"

ā€‹
data
object
required

Response data