List tags
GET
/v2/tags
Returns workspace tags using cursor pagination ordered by updated_at descending by default. Requires the tags:read scope.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
limitintegerOptional
1-100Defaults to 25Maximum number of results to return. Defaults to 25 and is capped at 100.
cursorstringOptional
Opaque cursor from a previous list response.
order_byenumOptional
Sort order for the list. Defaults to updated_at:desc.
Allowed values:
filter[updated_at][gt]datetimeOptional
Return resources updated strictly after the provided ISO-8601 UTC timestamp.
filter[updated_at][gte]datetimeOptional
Return resources updated at or after the provided ISO-8601 UTC timestamp.
filter[updated_at][lt]datetimeOptional
Return resources updated strictly before the provided ISO-8601 UTC timestamp.
filter[updated_at][lte]datetimeOptional
Return resources updated at or before the provided ISO-8601 UTC timestamp.
Response headers
X-Api-Versionstring
Response
Tag list response.
objectenum
Allowed values:
datalist of objects
has_moreboolean
next_cursorstring or null
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error