Delete an audience template

Last update: 2023-09-29
  • Created for:
  • Admin
    User
IMPORTANT

API endpoint: platform.adobe.io/data/core/activation/authoring/audience-templates

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.

IMPORTANT

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

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

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}
Parameter Description
{INSTANCE_ID} The ID of the audience template you want to delete.
 Request
curl -X DELETE https://platform.adobe.io/data/core/activation/authoring/audience-templates/{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}' \
 Response

A successful response returns HTTP status 200 along with an empty HTTP response.

API 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

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.

On this page