Delete campaign

This request will delete a campaign. You can delete a campaign in any status, except if it is part of a workflow. Once deleted, a campaign cannot be restored.

Request

Endpoint

DELETE https://api.woodpecker.co/rest/v2/campaigns/{campaign_id}

Headers

x-api-key: {YOUR_API_KEY}

For details on how to authenticate your requests, please see the authentication guide.

Request sample

Stop a campaign

cURL

curl --request DELETE \
  --url "https://api.woodpecker.co/rest/v2/campaigns/{campaign_id}" \
  --header "x-api-key: {YOUR_API_KEY}"

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.URISyntaxException;

HttpClient client = HttpClient.newHttpClient();

long campaignId = 12345;
String apiKey = "YOUR_API_KEY";
String url = "https://api.woodpecker.co/rest/v2/campaigns/" + campaignId;

HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create(url))
  .header("x-api-key", apiKey)
  .DELETE(HttpRequest.BodyPublishers.noBody())
  .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Node.js

const deleteCampaign = async (campaignId, apiKey) => {
  const url = `https://api.woodpecker.co/rest/v2/campaigns/${campaignId}`;

  const response = await fetch(url, {
    method: "DELETE",
    headers: {
      "x-api-key": apiKey,
    },
  });

  return await response.json();
};

try {
  const result = await deleteCampaign(12345, "YOUR_API_KEY");
  console.log(result);
} catch (error) {
  console.error("Error:", error);
}

Response

Response examples

200

The campaign has been deleted.

Status: 200
Body: none

401

An issue with authorization. Please review the authorization guide

{
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid api key",
  "timestamp": "2025-03-05 17:57:00"
}

Body schema

Field	Type	Description
title	string	A short title describing the error
status	integer	The HTTP status code
detail	string	A detailed message explaining the error
timestamp	string	The timestamp when the error occurred, YYYY-MM-DD HH:MM:SS UTC

404

The requested campaign doesn't exist.

{
  "code": "CAMPAIGN_NOT_EXIST",
  "message": "Campaign not found",
  "details": null
}

Body schema

Field	Type	Description
code	string	Error code
message	string	Descriptive error message
details	string/null	Additional information. Currently always null

409

The requested campaign is a part of an existing workflow. If you wish to delete this campaign - remove the workflow first.

{
  "code": "CAMPAIGN_RELATED_TO_ACTIVE_WORKFLOW",
  "message": "Campaign related to active workflow",
  "details": null
}

Body schema

Field	Type	Description
code	string	Error code
message	string	Descriptive error message
details	string/null	Additional information. Currently always null

500

An unknown error while deleting the campaign. Please try again later.

{
  "type": "UNKNOWN",
  "message": "Unknown error during delete campaign call",
  "details": null
}

Body schema

Field	Type	Description
code	string	Error code
message	string	Descriptive error message
details	string/null	Additional information. Currently always null