API Reference

Tags

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List

GET/tags

List all tags in use for the given projectId

Query ParametersExpand Collapse

pageSize: optional number

The number of items to return in the response. The default value is 50, maximum value is 100, minimum value is 1

minimum1

maximum100

paginationToken: optional string

A token you received in a previous request to query the next page of items

ReturnsExpand Collapse

tags: array of object { createdAt, itemCount, ownerId, 2 more }

createdAt: string

The tag creation date as an ISO string (example: “2023-02-03T11:19:41.579Z”)

itemCount: number

The number of items that have this tag

ownerId: string

The owner ID (example: “dcf121faaa1a0a0bbbd9ca1b73d62aea”)

tagName: string

The tag name

updatedAt: string

The tag last update date as an ISO string (example: “2023-02-03T11:19:41.579Z”)

nextPaginationToken: optional string

A token to query the next page of tags

List

HTTP

HTTP

TypeScript

Python

curl https://api.cloud.scenario.com/v1/tags \
    -u "$SCENARIO_SDK_API_KEY:SCENARIO_SDK_API_SECRET"

200 example

{
  "tags": [
    {
      "createdAt": "createdAt",
      "itemCount": 0,
      "ownerId": "ownerId",
      "tagName": "tagName",
      "updatedAt": "updatedAt"
    }
  ],
  "nextPaginationToken": "nextPaginationToken"
}

Returns Examples

200 example

{
  "tags": [
    {
      "createdAt": "createdAt",
      "itemCount": 0,
      "ownerId": "ownerId",
      "tagName": "tagName",
      "updatedAt": "updatedAt"
    }
  ],
  "nextPaginationToken": "nextPaginationToken"
}