Skip to main content
POST
/
v1
/
delegations
/
{delegationId}
/
roles
Create delegation role
curl --request POST \
  --url https://staging.api.us.aptlydone.com/decision/v1/delegations/{delegationId}/roles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "designeeRecipientType": "PERSONNEL_IN_POSITION",
  "isAutoIssue": false,
  "roleRequirement": "Lorem ipsum is a dummy requirement",
  "tenantId": "L14f5a115-52d0-4466-baff-740447a60774",
  "isCascade": false,
  "roleId": "14f5a115-52d0-4466-baff-740447a60774",
  "roleDesignees": [],
  "RoleStatus": "ASSIGNED"
}
'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T10:47:32.804Z",
  "message": "Success",
  "data": {
    "id": "14f5a115-52d0-4466-baff-740447a60774",
    "delegationId": "2sf90da4-0634-40b9-abf5-6e97a222rds8",
    "delegationRoleId": "7sf90da4-0634-40b9-abf5-6e97a222ttt8",
    "designeeRecipientType": "PERSONNEL_IN_POSITION",
    "isAutoIssue": false,
    "updatedAt": "2025-03-05T11:49:50.577Z",
    "createdAt": "2025-03-05T11:49:50.577Z",
    "roleDesignees": [],
    "roleDetails": {
      "id": "a97bbbc4-1415-4131-81fb-761fd111f370",
      "roleId": "10df93d6-4e88-40f9-b46a-1676017451ba",
      "roleName": "Informed",
      "roleStatus": "ASSIGNED",
      "roleRequirement": "Lorem ipsum is a dummy requirement",
      "isCascade": false,
      "isDeleted": false,
      "createdAt": "2025-03-19T14:45:37.301Z",
      "updatedAt": "2025-03-19T14:45:37.301Z"
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
delegationId
string
required

Body

application/json
​
designeeRecipientType
object
required

Delegation recipient type

Example:

"PERSONNEL_IN_POSITION"

​
isAutoIssue
object
required

Auto Issue option for Delegation recipient of type PERSONNEL_IN_POSITION

Example:

false

​
roleRequirement
string
required

Requirement of role delegation

Example:

"Lorem ipsum is a dummy requirement"

​
tenantId
string
required

tenantId for users and position

Example:

"L14f5a115-52d0-4466-baff-740447a60774"

​
isCascade
object
required

if true then propogate to child roles else no propogate occurs

Example:

false

​
roleId
string
required

Id of role

Example:

"14f5a115-52d0-4466-baff-740447a60774"

​
roleDesignees
object[]

Delegation Designees

​
RoleStatus
enum<string>

Status of the role

Available options:
ACTIVE,
INACTIVE,
ASSIGNED,
ACKNOWLEDGED
Example:

"ASSIGNED"

Response

201 - application/json

Role delegations created successfully

​
statusCode
number
required

HTTP Status code

Example:

200

​
timestamp
string
required

Timestamp of the response

Example:

"2025-06-24T10:47:32.804Z"

​
message
string
required

Response message

Example:

"Success"

​
data
object
required

Response data