Check cascading updates

PATCH /v1/delegations/check-cascading-updates

Check cascading updates

cURL

curl --request PATCH \
  --url https://staging.api.us.aptlydone.com/decision/v1/delegations/check-cascading-updates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "decisionId": "864fa115-52d0-4466-baff-740447a60774",
  "parentDelegationId": "726fa115-52d0-4466-baff-740447a60774",
  "updatedPathwayOptions": [
    "Matrix",
    "Direct Line",
    "Functional"
  ],
  "updatedDelegationGroups": [
    {
      "groupId": "105fa115-52d0-4466-baff-740447a60774",
      "tenantGroupTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "displayName": "Engineering Team",
      "groupName": "Engineering Team",
      "isInvalid": false
    }
  ],
  "updatedDelegationAuthorities": [
    {
      "authorityTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "authorityLimit": "Primary",
      "authorityLimitValueType": "Currency",
      "authorityLimitOperator": "<=",
      "redelegable": true,
      "authorityTypeOrder": 1,
      "authorityLimitValue": "1000000",
      "authorityLimitValueUnit": "$",
      "redelegationLimitValue": "500000",
      "redelegationLimitValueUnit": "$",
      "isInvalid": false,
      "isLimitOverridden": false
    }
  ],
  "updatedDecisionGroups": [
    {
      "groupId": "105fa115-52d0-4466-baff-740447a60774",
      "tenantGroupTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "displayName": "Engineering Team",
      "groupName": "Engineering Team"
    }
  ],
  "updatedDecisionAuthorities": [
    {
      "authorityTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "authorityType": "Approval",
      "authorityLimit": "Primary",
      "authorityLimitValueType": "Currency",
      "authorityLimitOperator": "<=",
      "authorityTypeOrder": 1,
      "authorityTypeIcon": "check-square",
      "authorityLimitValue": "1000000",
      "authorityLimitValueUnit": "$"
    }
  ]
}
'

200

{
  "statusCode": 200,
  "timestamp": "2026-01-08T06:33:50.384Z",
  "message": "Success",
  "data": {
    "numberOfChildDelegationsInvalidated": false,
    "childDelegationsInvalidated": false
  }
}

Authorizations

Authorization · string · header · required

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

Body

application/json

decisionId · string

ID of decision being edited which will potentially cascade updates to its child delegations

Example:

"864fa115-52d0-4466-baff-740447a60774"

parentDelegationId · string

ID of delegation being edited which will potentially cascade updates to its child delegations

Example:

"726fa115-52d0-4466-baff-740447a60774"

updatedPathwayOptions · array[]

Updated Delegation Pathway options

Example:

["Matrix", "Direct Line", "Functional"]

updatedDelegationGroups · object[]

Updated Delegation Groups

Show child attributes

updatedDelegationAuthorities · object[]

Updated Delegation Authorities

Show child attributes

updatedDecisionGroups · object[]

Updated Decision Groups

Show child attributes

updatedDecisionAuthorities · object[]

Updated Decision Authorities

Show child attributes

Response

200 - application/json

Cascading updates checked successfully before Delegation update

statusCode · number · required

HTTP Status code

Example:

200

timestamp · string · required

Timestamp of the response

Example:

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

message · string · required

Response message

Example:

"Success"

data · object · required

Response data

Show child attributes