List tags within a project

post

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

Retrieves a list of all tags defined for a specific project. Tags are keywords used to categorize and organize experiences, goals, audiences, etc., for easier management and filtering. The Knowledge Base article "Adding tags to your Experiences" explains their use.

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 to which save/retrieved data is connected

Body Params

Optional filters for listing tags, primarily search for tag names and pagination parameters (page, results_per_page). Also supports only/except for specific tag IDs.

results_per_page

integer | null

0 to 50

Defaults to 30

Specifies the maximum number of items to return in a single page of results. Used for pagination. Default is 30, maximum is 50.

page

integer

≥ 1

The page number for paginated results. For example, if results_per_page is 30, page: 2 will retrieve items 31-60. Defaults to 1 if not specified.

only

array of integers | null

Only retrieve tags with the given ids.

only

except

array of integers

length ≤ 100

Except tags with the given ids.

except

string | null

A search string that would be used to search against Tag's name

Responses

Language

Credentials

URL

Loading…

Response

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

application/json

200A list of tags defined within a project. Each tag has an id, name, and description. Tags are used for organizing entities like experiences or goals.

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.