Update a single tag

Description

Updates the tag that matches the provided ID with the details provided in the body. Ignores the provided key, as keys are immutable once set. There is a limit of 300 values for a tag.

PUT /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
body	body	TagDto	true	The representation of the tag to update

Body parameter example

{
  "key": "string",
  "values": [
    "string"
  ]
}

Code Samples

curl

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

httpie

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

wget

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

python

import requests

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

r = requests.put('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 a TagDto object for the updated tag.

Example Responses

OK

{
  "body": {
    "created": "string",
    "id": "string",
    "key": "string",
    "updated": "string",
    "userId": "string",
    "values": [
      "string"
    ],
    "version": "integer"
  },
  "code": "integer"
}