Attention: List Labels

List the conversation labels in your Attention organization.

Tool ID: attention_list_labels

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_list_labels',
  {
    "page": 1,
    "size": 50
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute attention_list_labels --input '{
  "page": 1,
  "size": 50
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "uuid": "uuid_123",
        "name": "Example",
        "aiFlow": true,
        "allTeams": true,
        "isDefaultTemplate": true,
        "organizationUUID": "organization_123",
        "createdAt": "2026-01-15T12:00:00Z"
      }
    ],
    "meta": {
      "pageCount": 123,
      "totalRecords": 123,
      "pageNumber": 123
    }
  }
}

Use deepline describe attention_list_labels --json for the latest machine-readable contract.

Input reference

Retrieves a paginated list of labels for the authenticated organization. Labels are used to categorize conversations and drive AI flows, scorecard criteria, and intelligence-item-collection criteria. Only labels belonging to the caller’s organization are returned.

Name	Type	Required	Default	Details
`payload.page`	`integer`	No	`1`	1-indexed page number to return. Defaults to 1. Minimum: 1.
`payload.size`	`integer`	No	`50`	Number of labels per page. Defaults to 50. Maximum 200. Minimum: 1. Maximum: 200.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Paginated list-response envelope for labels.
`result.data.data`	`array`	No	—	The page of labels belonging to the caller’s organization.
`result.data.data[].uuid`	`string`	Yes	—	Unique identifier of the label.
`result.data.data[].name`	`string`	Yes	—	Human-readable label name. Unique per organization. Trimmed. 1 to 128 characters.
`result.data.data[].description`	`string`	No	—	Longer description of the label’s meaning or criteria. 0 to 2000 characters.
`result.data.data[].aiFlow`	`boolean`	Yes	—	Whether this label participates in the AI flow (auto-classification during conversation post-processing).
`result.data.data[].allTeams`	`boolean`	Yes	—	Whether this label applies to all teams in the organization. When false, label visibility is constrained by team assignments managed through the internal API.
`result.data.data[].isDefaultTemplate`	`boolean`	Yes	—	Whether this label originated from the organization’s default template. Default-template labels are typically managed as a system-seeded group.
`result.data.data[].options`	`array`	No	—	Optional set of selectable values when the label is a multi-value enum. Empty or omitted for binary labels.
`result.data.data[].options[].value`	`string`	No	—	The option value as displayed to callers. Stored as an arbitrary JSON value server-side. surfaced here as a string for REST ergonomics.
`result.data.data[].options[].description`	`string`	No	—	Optional human-readable description of the option, used for tooltips and AI-flow prompts.
`result.data.data[].organizationUUID`	`string`	Yes	—	UUID of the organization that owns the label. Always matches the authenticated principal’s organization on responses.
`result.data.data[].createdAt`	`string`	Yes	—	Timestamp when the label was created, in ISO 8601 (RFC 3339) format. Format: `date-time`.
`result.data.meta`	`object`	No	—	—
`result.data.meta.pageCount`	`integer`	No	—	—
`result.data.meta.totalRecords`	`integer`	No	—	—
`result.data.meta.pageNumber`	`integer`	No	—	—
`result.data.meta.pageSize`	`integer`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation