Delete a single tag

Description

Deletes the tag with the provided ID. If no such tag is found, this is a no-op.

DELETE /api/v1/tag/{tagId}

Required OAuth Scopes

No OAuth scopes are required to use this endpoint.

Parameters

Parameter	In	Type	Required	Description
tagId	path	string	true	The unique identifier of the tag

Code Samples

curl

curl -X DELETE https://h.app.wdesk.com/s/wdata/prep/api/v1/tag/{tagId} \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}'

httpie

http DELETE https://h.app.wdesk.com/s/wdata/prep/api/v1/tag/{tagId} \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=DELETE "https://h.app.wdesk.com/s/wdata/prep/api/v1/tag/{tagId}" \
    --output-document -  \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}'

python

import requests

headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://h.app.wdesk.com/s/wdata/prep/api/v1/tag/{tagId}', headers = headers)

print(r.json())

Returns

200 - OK

Returns a JSON object with a body property, which contains the ID of the deleted resource.

Example Responses

OK

{
  "body": "string",
  "code": "integer"
}