Skip to main content
GET
/
v1
/
tags
/
{uid}
Retrieve a Tag
curl --request GET \
  --url https://api.siit.io/v1/tags/{uid} \
  --header 'Authorization: Bearer <token>'
{
  "uid": "<string>",
  "value": "<string>",
  "kind": "team",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}

​
Note

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.

Path Parameters

​
uid
string
required

The UID of the Tag

Response

Tag show

​
uid
string

The UID of the Tag

​
value
string

The Tag name

​
kind
enum<string>

The type of tag

Available options:
team,
request_inbox,
request_tag,
legal_entity,
office_location,
department
​
updated_at
string<date-time>

datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")

​
created_at
string<date-time>

datetime formatted as ISO 8601 (e.g. "2020-12-15T03:34:13.000Z")