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": "1d2ca3f4-9932-4032-b8cf-4f30f3369bd9",
  "roleName": "Approver",
  "status": "ACTIVE"
}'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T08:51:42.214Z",
  "message": "Success",
  "data": {
    "id": "4e2e1f93-4a15-45a8-b9c1-635e9fc2fe14",
    "tenantId": "2ef55a4e-d3ad-48df-97dd-e547819299e7",
    "roleName": "Approver",
    "isDeleted": false,
    "status": "ACTIVE"
  }
}

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:

"1d2ca3f4-9932-4032-b8cf-4f30f3369bd9"

​
roleName
string
required

Role name

Maximum 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:

"2025-06-24T08:51:42.214Z"

​
message
string
required

Response message

Example:

"Success"

​
data
object
required

Response data