Delete a destination server configuration

This page exemplifies the API request and payload that you can use to delete an existing destination server configuration, using the /authoring/destination-servers API endpoint.

For a detailed description of the capabilities that you can delete through this endpoint, read the following articles:

Getting started with destination server API operations get-started

Before continuing, please review the getting started guide for important information that you need to know to successfully make calls to the API, including how to obtain the required destination authoring permission and required headers.

Delete a destination server configuration delete

You can delete an existing destination server configuration by making a DELETE request to the /authoring/destination-servers endpoint with the {INSTANCE_ID}of the destination server configuration that you want to delete.

To obtain an existing destination server configuration and its corresponding {INSTANCE_ID}, see the article about retrieving a destination server configuration.

API format

DELETE /authoring/destination-servers/{INSTANCE_ID}

curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/destination-servers/{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \

API error handling error-handling

Destination SDK API endpoints follow the general Experience Platform API error message principles. See API status codes and request header errors in the Experience Platform troubleshooting guide.

Next steps next-steps

After reading this document, you now know how to delete an existing destination server through the Destination SDK /authoring/destination-servers API endpoint.

To learn more about what you can do with this endpoint, see the following articles: