Skip to main content
GET
List tags

Authorizations

Authorization
string
header
required

Project-scoped secret API key (sk_…). Pass in the Authorization: Bearer <key> header. Grants access to the project the key was issued for.

Query Parameters

cursor
string

Opaque cursor returned by a previous page response. Omit on the first request.

page
enum<string>

Direction to walk relative to cursor. Defaults to next when omitted.

Available options:
next,
prev
limit
integer | null
default:25

Maximum results per page. Use -1 to request all (rate-limited; large pages may be rejected).

Required range: -1 <= x <= 100
Example:

25

sort
string

Field to sort by. Defaults vary per resource.

Example:

"created_at"

direction
enum<string>

Sort direction. Defaults vary per resource.

Available options:
asc,
desc
q
string

Free-text search across the resource’s indexed fields.

Response

A page of tags.

Paginated response of TagList.

results
object[]
required

Page of results, ordered per the request’s sort and direction.

nextCursor
string | null
required

Opaque cursor for the next page. null when no further pages exist.

prevCursor
string | null
required

Opaque cursor for the previous page. null when on the first page.

limit
integer
required

Page size used to build this response.