Skip to main content
GET
List call tags

Authorizations

Authorization
string
header
required

HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).

Query Parameters

callType
enum<string>

Returns the tags meant for this direction plus the tags meant for both. Leave it out to skip the direction filter.

Available options:
incoming,
outgoing
groupId
string

Only tags visible to this group, plus tags visible to every group. Cannot be combined with userId.

Example:

"12"

userId
string

Only tags visible to one of this user's groups, plus tags visible to every group. Cannot be combined with groupId.

Example:

"4521"

limit
integer
default:20

Page size, 1 to 100. Out-of-range values are clamped and the value used is echoed in pagination.limit. A value that is not a whole number, such as abc or 1.5, is rejected with 400 VALIDATION.INVALID_PARAMETER.

Example:

20

cursor
string

Opaque cursor from a previous page's pagination.next. Pass it back unchanged. Send it with the same filters. A malformed cursor is rejected with 400 PAGINATION.INVALID_CURSOR.

Response

One page of call tags.

data
object[]
required
pagination
object
required
requestId
string
required