Update an existing tag

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/tags/{tag_id}/update

Modifies the name or description of an existing tag.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project into which the tag is to be stored

tag_id

integer

required

ID of the tag to be updated

Body Params

Represents a tag (keyword or label) that can be associated with various Convert entities like experiences, goals, audiences, hypotheses, and observations. Tags help organize and categorize these entities for easier filtering, searching, and management. Knowledge Base: "Adding tags to your Experiences".

name

string

length ≤ 100

The user-defined name of the tag (e.g., "Q3 Campaigns", "Homepage Tests", "High Priority", "Mobile Specific"). This is the primary identifier shown in the UI.

description

string | null

(Optional) A brief explanation of the tag's purpose or the criteria for its application.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Details for a single tag, including its id, name, and description.

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.