Delete an audience template

API endpoint:

This page exemplifies the API request and payload that you can use to delete an audience template, using the /authoring/audience-templates API endpoint.

For a detailed description of the capabilities that you can configure through this endpoint, see audience metadata management.

All parameter names and values supported by Destination SDK are case sensitive. To avoid case sensitivity errors, please use the parameters names and values exactly as shown in the documentation.

Getting started with audience template API operations get-started

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

Delete an audience template delete

You can delete an existing audience template by making a DELETE request to the /authoring/audience-templates endpoint with the {INSTANCE_ID}of the audience template that you want to delete.

To obtain an existing audience template and its corresponding {INSTANCE_ID}, see the article about retrieving an audience template.

API format

DELETE /authoring/audience-templates/{INSTANCE_ID}
The ID of the audience template you want to delete.
code language-shell
 -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}' \
A successful response returns HTTP status 200 along with an empty HTTP response.

API error handling error-handling

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

Next steps next-steps

After reading this document, you now know how to delete an audience template using the /authoring/audience-templates API endpoint. Read how to use Destination SDK to configure your destination to understand where this step fits into the process of configuring your destination.