GET
/
v1
/
tags
List Tags
curl --request GET \
  --url https://api.siit.io/v1/tags \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "count": 123,
    "total": 123,
    "current_page": 123,
    "per_page": 20,
    "next_page_link": "<string>",
    "previous_page_link": "<string>"
  },
  "results": [
    {
      "uid": "<string>",
      "value": "<string>",
      "kind": "team",
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

​
Introduction

A tag can only be attached to one type of object, so a Tag with a kind: "request_tag" will only be usable on Requests, while a Tag with a kind: "request_inbox" cannot appear in a Request#tag_uids[] field.

​
Usage

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
kind_in[]
enum<string>[]

Filter by Tag's kind.

​
created_after
string

Filter Tags created after a DateTime (ISO 8601).

​
created_before
string

Filter Tags created before a DateTime (ISO 8601).

​
updated_after
string

Filter Tags updated after a DateTime (ISO 8601).

​
updated_before
string

Filter Tags updated before a DateTime (ISO 8601).

​
page
integer

The current page

​
per_page
integer

Number of results retrieved per page.

Response

200
application/json

Successful

The response is of type object.