PATCH
/
v1
/
delegations
/
{id}
Update delegation
curl --request PATCH \
  --url https://staging.api.us.aptlydone.com/decision/v1/delegations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "DRAFT",
  "isRootDelegation": false,
  "issuerType": "ROOT_AUTHORITY",
  "issuerUserId": "648fa115-52d0-4466-baff-740447a60774",
  "issuerPositionId": "257fa115-52d0-4466-baff-740447a60774",
  "recipientType": "PERSONNEL_IN_POSITION",
  "recipientAutoIssue": false,
  "decisionId": "864fa115-52d0-4466-baff-740447a60774",
  "parentDelegationId": "726fa115-52d0-4466-baff-740447a60774",
  "expirationDate": "2025-12-31T12:00:00Z",
  "isNoExpiration": false,
  "effectiveDate": "2025-01-01T12:00:00Z",
  "delegationPathway": [
    {
      "pathwayTypeName": [
        "Matrix",
        "Direct Line",
        "Functional"
      ],
      "isInvalid": false
    }
  ],
  "delegationRecipients": [
    {
      "recipientUserId": "485fa115-52d0-4466-baff-740447a60774",
      "recipientPositionId": "14f5a115-52d0-4466-baff-740447a60774",
      "isInvalid": false
    }
  ],
  "delegationGroups": [
    {
      "groupId": "105fa115-52d0-4466-baff-740447a60774",
      "tenantGroupTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "isInvalid": false
    }
  ],
  "delegationAuthorities": [
    {
      "authorityTypeId": "105fa115-52d0-4466-baff-740447a60774",
      "authorityTypeOrder": 1,
      "authorityLimit": "Primary",
      "authorityLimitValueType": "Value (currency)",
      "authorityLimitOperator": "<=",
      "authorityLimitValue": "1000000",
      "authorityLimitValueUnit": "$",
      "redelegable": true,
      "redelegationLimitValue": "500000",
      "redelegationLimitValueUnit": "$",
      "isInvalid": false,
      "isLimitOverridden": false
    }
  ],
  "delegationDocuments": [
    {
      "documentId": "105fa115-52d0-4466-baff-740447a60774",
      "isPinned": true
    }
  ],
  "isInvalid": false,
  "invalidFields": [
    "delegationGroups",
    "delegationAuthorities"
  ]
}'
{
  "id": "9f45f94d-20d2-4163-85d9-68f4f699e440",
  "tenantId": "105fa115-52d0-4466-baff-740447a60774",
  "status": "DRAFT",
  "isRootDelegation": false,
  "issuerType": "ROOT_AUTHORITY",
  "issuerUserId": "648fa115-52d0-4466-baff-740447a60774",
  "issuerPositionId": "257fa115-52d0-4466-baff-740447a60774",
  "recipientType": "PERSONNEL_IN_POSITION",
  "recipientAutoIssue": false,
  "decisionId": "864fa115-52d0-4466-baff-740447a60774",
  "parentDelegationId": "726fa115-52d0-4466-baff-740447a60774",
  "issuedDate": "2025-01-01T12:00:00Z",
  "expirationDate": "2025-12-31T12:00:00Z",
  "isNoExpiration": false,
  "effectiveDate": "2025-01-01T12:00:00Z",
  "copiedFrom": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
  "delegationPathway": [],
  "delegationRecipients": [],
  "delegationGroups": [],
  "delegationAuthorities": [],
  "delegationDocuments": [],
  "delegationDisplayId": "12789",
  "link": "/delegations/view/eyJ0ZW5hbnRJZCI6IjEwNWZhMTE1LTUyZDAtNDQ2Ni1iYWZmLTc0MDQ0N2E2MDc3NCIsImRlbGVnYXRpb25JZCI6IjMwOGNiMzMxLWYwMTgtNGJjNS1hMWE3LTQ1MTI4NTU4MTg0MyJ9",
  "delegationId": "9f45f94d-20d2-4163-85d9-68f4f699e440",
  "sourceDecision": {
    "id": "7df90da4-0634-40b9-abf5-6e97a222cfb8",
    "decisionDisplayId": "14623",
    "name": "Long-term Investments",
    "description": "The Long-term Investments authority involves approving strategic investments",
    "guidance": "Investment decisions for long-term, strategic investments...",
    "sectionId": "105fa115-52d0-4466-baff-740447a60774",
    "categoryId": "248fa115-52d0-4466-baff-740447a60774"
  },
  "isInvalid": false,
  "invalidFields": [
    "delegationGroups",
    "delegationAuthorities"
  ],
  "actionIssuerApproval": true,
  "actionDelegationAcceptance": true,
  "actionAuthorityRequest": true,
  "approvalActionExistForUser": true,
  "acceptanceActionExistForUser": true
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Body

application/json

Response

200 - application/json

Delegation updated successfully

The response is of type object.