Skip to main content
POST
Create a tag

Authorizations

Authorization
string
header
required

Enter your API Key (sk_live_xxx or sk_test_xxx)

Headers

x-workspace-id
string<uuid>

Target workspace id (from GET /v1/workspaces). Required for multi-workspace API keys to designate which workspace to write to; omit for single-workspace keys, where it is resolved automatically. Must be within the API key scope.

Body

application/json
label
string
required

The label of the tag

Example:

"Lead"

isSuccessTag
boolean
default:false

Whether the tag represents a successful call outcome

Example:

false

Response

Tag created successfully

id
string
required

Unique identifier of the tag

Example:

"123e4567-e89b-12d3-a456-426614174000"

label
string
required

Label of the tag

Example:

"Lead"

isSuccessTag
boolean
required

Whether the tag represents a successful call outcome

Example:

true

createdAt
string<date-time>
required

Date when the tag was created

Example:

"2024-01-15T10:30:00.000Z"

updatedAt
string<date-time>
required

Date when the tag was last updated

Example:

"2024-01-15T10:30:00.000Z"