Manage Association Approvers
    • PDF

    Manage Association Approvers

    • PDF

    Article summary

    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




    Was this article helpful?