Updating a Tag

Prev Next
Post
/tags/{TAG_ID}

This API updates/changes the name/content of a tag.
The tag’s Id is required as part of the URL.
The actual changes to the tag are part of the Body Params - the new name/content.


If you want to add the tag to a certain tags group, the TagGroupId is required. See example.

The API returns the call status update (no data).

Security
HTTP
Type bearer

API key is needed to authorize requests. You can get your API key via the management console.
A Bearer Token is needed to be set in the Authorization header of every API call.
For additional support you can contact us.

Path parameters
TAG_ID
Required

Tag ID. This is a commbox generated number

Body parameters

Optional description for new mail object in Markdown

Expand All
object
data
object
Name
string
ExampleUpdated name of my tag
TagGroupId
integer (int64)
Example1233770190
Responses
200

OK

Expand All
object
status
string
Example200
description
string
ExampleOperation successful
response_time
string
Example2025-08-06T07:51:52.2581942Z
data
object
id
string
Example
400

Bad Request - The request could not be understood by the server. Incoming parameters might not be valid

object
status
integer
Example400
description
string
ExampleBad Request
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
401

Unauthorized - The supplied credentials, if any, are not sufficient to access the resource

object
status
integer
Example401
description
string
ExampleUnauthorized
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
404

Not found - The requested resource is not found

object
status
integer
Example404
description
string
ExampleNot Found
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
429

Too Many Requests - Too many requests have been made in a short period of time (Throttling)

object
status
integer
Example429
description
string
ExampleToo Many Requests
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z
500

Server Error - The server could not return the representation due to an internal server error

object
status
integer
Example500
description
string
ExampleInternal Server Error
response_time
string (date-time)
Example2025-02-06T07:51:52.258Z