Manage Association Approvers

Prev Next

1.Get Associations and Approver Group Combination Configured for an Application

This method retrieves associations and approver group combinations configured for an application.

GET

{{url}}/api/apps/{appId}/association-approvers

Request Parameters

curl --location --request GET '{{url}}/api/apps/{appId}/association-approvers' \
--header 'Authorization: TOKEN {{token}}'

Request Example

The request parameter used in this method is shown in the following table:

Parameter

Description

Data Type

Required

appId

Id of the application

String

Mandatory

Response Example

{
    "associationApproversSummary":[
       {
          "id":"bfd84a78-0ff2-4cf9-886b-05a2a563441c",
          "name":"testaap",
          "associations":[
             {
                "id":"ou-pak3-slpfjl4r",
                "type":1
             }
          ],
          "approversGroups":[
             {
                "id":"74a28c2d-cb24-4581-b1c3-184d5aae2f0c",
                "name":"auto_agrp2_KyroO",
                "condition":"Any",
                "members":[
                   {
                      "id":"anxnurayz8yzj3pg5zpu",
                      "name":"Req-Tag",
                      "memberType":"Tag"
                   }
                ]
             }
          ]
       }
    ]
 }

Status: 200 OK


2. Create Association Approvers Combination for an Application

The POST method creates association Approvers combination for an application.

POST

{{url}/api/apps/{appId}/association-approvers

Request Parameter

Parameter

Description

Data Type

Required

appId

Id of the application

String

Mandatory

Request Parameters

An example POST request for creating a new application is shown here.

curl --location --request POST '{{url}}/api/apps/{appId}/association-approvers' \
--header 'Authorization: TOKEN {{token}}'{
    "name":"testaap",
    "associations":[
       {
          "type":0,
          "id":"196226166352"
       }
    ],
    "approversGroups":[
       {
          "id":"74a28c2d-cb24-4581-b1c3-184d5aae2f0c"
       }
    ]
 }

Response Example

{
    "id" : "25bc80ce-82eb-4666-bfb5-7d5777f09c45",
    "name" : "testaap1",
    "associations" : [ {
      "id" : "196226166352",
      "type" : 0
    } ],
    "approversGroups" : [ {
      "id" : "74a28c2d-cb24-4581-b1c3-184d5aae2f0c",
      "name" : "auto_agrp2_KyroO",
      "condition" : "Any",
      "members" : [ {
        "id" : "anxnurayz8yzj3pg5zpu",
        "name" : "Req-Tag",
        "memberType" : "Tag"
      } ]
    } ]
  }

Status: 200 OK


3.Get Configured Association and Approvers by id to an Application

The GET method retrieves the configured association and approvers by id to an application.

GET

{{url}}/api/apps/{appId}/association-approvers/{id}

Request Parameters

Parameter

Description

Data Type

Required

appId

Id of the application

String

Mandatory

Id

Id of the association approvers

String

Mandatory

Request Example

curl --location --request GET '{{url}}/api/apps/{appId}/association-approvers/{id}' \
--header 'Authorization: TOKEN {{token}}'

Response Example

{
    "id" : "25bc80ce-82eb-4666-bfb5-7d5777f09c45",
    "name" : "testaap1",
    "associations" : [ {
      "id" : "196226166352",
      "type" : 0
    } ],
    "approversGroups" : [ {
      "id" : "74a28c2d-cb24-4581-b1c3-184d5aae2f0c",
      "name" : "auto_agrp2_KyroO",
      "condition" : "Any",
      "members" : [ {
        "id" : "anxnurayz8yzj3pg5zpu",
        "name" : "Req-Tag",
        "memberType" : "Tag"
      } ]
    } ]
  }

Status: 200 OK


4. Delete Association Approvers Configured for a given id in an Application

DELETE

{{url}}/api/apps/{appId}/association-approvers/{id}

Request Parameter

Parameter

Description

Data Type

Required

appId

Id of the application

String

Mandatory

Id

Id of the association approvers

String

Mandatory

Request Example

curl --location --request DELETE '{{url}}/api/apps/{appId}/association-approvers/{id}' \
--header 'Authorization: TOKEN {{token}}'

Status: 204 No Content


5. Update Association and Approvers for a given id

PATCH

{{url}}/api/apps/{appId}/association-approvers/{id}

Request Parameter

The request parameters used in this method is shown in the following table:

Parameter

Description

Data Type

Required

appId

Id of the application

String

Mandatory

Id

Id of the association approvers

String

Mandatory

Request Example

curl --location --request PATCH '{{url}}/api/apps/{appId}/association-approvers/{id}' \
--header 'Authorization: TOKEN {{token}}' {
   "associations":[
      {
         "type":1,
         "id":"ou-pak3-slpfjl4r"
      },
      {
         "type":0,
         "id":"546836430071"
      }
   ],
   "approversGroups":[
      {
         "id":"74a28c2d-cb24-4581-b1c3-184d5aae2f0c"
      },
      {
         "id":"b51220f8-8351-4aa9-8c76-9b693d35ba8c"
      }
   ]
}

Response Example

Status: 204 No Content