Plugins API - DELETE a plugin's endpoint

Deletes the specified endpoint of the ActiveGate plugin.

DELETE
  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/plugins/{id}/endpoints/{endpointId}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/config/v1/plugins/{id}/endpoints/{endpointId}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/plugins/{id}/endpoints/{endpointId}

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter Type Description In Required
id string

The ID of the plugin where you want to delete an endpoint.

 path required
endpointId string

The ID of the endpoint to be deleted.

 path required

Response

Response codes

Code Description
204

Deleted. Response doesn't have a body.

Response body

A successful request doesn't return any content.

Example

In this example, the request deletes the endpoint with the ID of 8757307336635955682 from the SAP plugin, which has the ID of custom.remote.python.sap. The response code of 204 indicates that the deletion was successful.

The API token is passed in the Authorization header.

Curl

curl -X DELETE \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/plugins/custom.remote.python.sap/endpoints/8757307336635955682 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

DELETE https://mySampleEnv.live.dynatrace.com/api/config/v1/plugins/custom.remote.python.sap/endpoints/8757307336635955682

Response code

204