API > Lists > Delete list tag

DELETE https://emailoctopus.com/api/1.6/lists/:listId/tags/:listTag

Delete list tag

Parameters
api_key (string)	Your API key.

200 (success) returns
An empty response.

Non-200 (error) returns

Details of the error:

code (string)	The error code.
message (string)	A description of the error.

Method-specific error codes
TAG_NOT_FOUND	A tag with the supplied name could not be found for the given list.
TAG_IN_USE	The tag with the supplied name is in use in a list segment.

API-wide error codes
INVALID_PARAMETERS	Parameters are missing or invalid.
API_KEY_INVALID	Your API key is invalid.
UNAUTHORISED	You're not authorised to perform that action.
NOT_FOUND	The requested endpoint does not exist.
UNKNOWN	An unknown error has occurred.

Example request
/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000

Example response
`{}`

Code sample cURL copy
curl -X DELETE \ https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000 curl -X DELETE \ https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000
$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE'); $result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); x $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE'); $result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch);
import requests params = ( ('api_key', '00000000-0000-0000-0000-000000000000'), ) response = requests.delete('https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip', params=params) xxxxxxxxxx import requests params = ( ('api_key', '00000000-0000-0000-0000-000000000000'), ) response = requests.delete('https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip', params=params)
var https = require('https'); var options = { hostname: 'emailoctopus.com', port: 443, path: '/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000', method: 'DELETE', }; var req = https.request(options); req.end(); xxxxxxxxxx var https = require('https'); var options = { hostname: 'emailoctopus.com', port: 443, path: '/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000', method: 'DELETE', }; var req = https.request(options); req.end();
package main import ( "io/ioutil" "log" "net/http" ) func main() { client := &http.Client{} req, err := http.NewRequest("DELETE", "https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000", nil) if err != nil { log.Fatal(err) } resp, err := client.Do(req) if err != nil { log.Fatal(err) } bodyText, err := ioutil.ReadAll(resp.Body) if err != nil { log.Fatal(err) } } xxxxxxxxxx package main import ( "io/ioutil" "log" "net/http" ) func main() { client := &http.Client{} req, err := http.NewRequest("DELETE", "https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags/vip?api_key=00000000-0000-0000-0000-000000000000", nil) if err != nil { log.Fatal(err) } resp, err := client.Do(req) if err != nil { log.Fatal(err) } bodyText, err := ioutil.ReadAll(resp.Body) if err != nil { log.Fatal(err) } }