Create a tag using delegated auth

Requires the admin:workspace scope and a Workspace Admin+ role. Three mutually exclusive shapes: a flat tag (default), a single-select group (tagType single_select plus ordered values), or a new value in an existing group (parentTagId only).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
string
required
length between 1 and 50
string
enum
Defaults to conversation
Allowed:
string
^#[0-9a-fA-F]{6}$
string
length ≤ 200
string
enum
Defaults to flat
Allowed:
values
array of objects
length between 1 and 20
values
string
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
string
required
length between 1 and 255
Responses

Language
Credentials
Bearer
Delegated OAuth
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json