DELETE
/
v1
/
positions
Delete multiple positions
curl --request DELETE \
  --url https://staging.api.us.aptlydone.com/settings/v1/positions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "781a4ffd-40fb-4357-8b25-238d75121c6a, de4c2ae6-2fd0-44ab-8382-d2ba364b7e4a"
  ]
}'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T08:51:42.214Z",
  "message": "Success",
  "data": [
    {
      "id": "5e30e192-a922-45d6-a35f-196c94bebd05",
      "tenantId": "b07b13fd-15ec-4d79-963c-3958a90c4f6e",
      "positionId": "10000",
      "positionName": "Senior Developer",
      "isSCIMProvisioned": false,
      "status": "ACTIVE",
      "isDeleted": false,
      "createdOn": "2025-01-13T12:34:59.300Z",
      "updatedOn": "2025-01-13T12:34:59.300Z",
      "groups": [
        {
          "groupName": "Engineering Team",
          "groupTypeName": "Organizations",
          "groupId": "52fb829d-da34-427e-a528-4d3baf5968ca",
          "groupTypeId": "e21d3dec-fa12-48ea-b800-71faa767394c",
          "parentId": 2,
          "parentName": "Technology Division",
          "createdAt": "2025-01-13T12:34:59.303Z",
          "updatedAt": "2025-01-13T12:34:59.303Z"
        }
      ],
      "delegationsReceived": 1,
      "delegationsIssued": 1
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Body

application/json

Response

200 - application/json

Positions deleted successfully

The response is of type object.