Updated on 2025-10-27 GMT+08:00

Deleting an Endpoint

Function

This API is used to delete an endpoint.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

DELETE /v1/endpoint-groups/{endpoint_group_id}/endpoints/{endpoint_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

endpoint_group_id

Yes

String

Specifies the endpoint group ID.

endpoint_id

Yes

String

Specifies the endpoint ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Specifies the user token. The token can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 204

Endpoint deleted.

None

Example Requests

Deleting an endpoint

DELETE https://{ga_endpoint}/v1/endpoint-groups/3a9f50bb-f041-4eac-a117-82472d8a0007/endpoints/0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d

Example Responses

None

Status Codes

Status Code

Description

204

Endpoint deleted.

Error Codes

See Error Codes.