Remove an existing audience

DELETE/audiences/{id}Remove an existing audience

Deprecated: Use Segments instead. These endpoints still work, but will be removed in the future.

Parameters

idstringpathrequired

The Audience ID.

Responses

objectdeprecatedRemoveAudienceResponseSuccess

deletedboolean

The deleted attribute indicates that the corresponding audience has been deleted.

idstring

The ID of the audience.

objectstring

The object of the audience.

Example response

{
  "deleted": true,
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "audience"
}

Examples

idrequiredpath parameter

curl -X DELETE 'https://api.resend.com/audiences/string'

const response = await fetch('https://api.resend.com/audiences/string', { method: 'DELETE' });
const data = await response.json();

const response = await fetch('https://api.resend.com/audiences/string', { method: 'DELETE' });
console.log(await response.json());

import requests

response = requests.request("DELETE", "https://api.resend.com/audiences/string")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "DELETE", "https://api.resend.com/audiences/string", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/audiences/string");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "DELETE");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/audiences/string"))
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/audiences/string")
request = Net::HTTPGenericRequest.new("DELETE", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Delete, "https://api.resend.com/audiences/string");
using var response = await client.SendAsync(request);

{
  "deleted": true,
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "audience"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys