Updated on 2022-08-16 GMT+08:00

Deleting an Agency

Function

This API is used to delete an agency.

After this operation, the delegated party can no longer access the relevant resources. Exercise caution when performing this operation.

URI

  • URI format

    DELETE /v3.0/OS-AGENCY/agencies/{agency_id}

  • URI parameters

    Parameter

    Mandatory

    Type

    Description

    agency_id

    Yes

    String

    ID of an agency.

Request Parameters

  • Parameters in the request header

    Parameter

    Mandatory

    Type

    Description

    Content-Type

    Yes

    String

    Fill application/json;charset=utf8 in this field.

    X-Auth-Token

    Yes

    String

    Authenticated token with the Security Administrator permission.

  • Example request
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X DELETE https:///v3.0/OS-AGENCY/agencies/2809756f748a46e2b92d58d309f67291

Response Parameters

  • Example response (request failed)
    {
        "error": {
            "message": "Could not find agency: 2809756f748a46e2b92d58d309f67291",
            "code": 404,
            "title": "Not Found"
        }
    }

Status Codes

Status Code

Description

204

The request is successful.

401

Authentication failed.

403

Access denied.

404

The requested resource cannot be found.

500

Internal server error.