# Queues and human agents

> Queues, skills, wrap-up codes, canned responses and coverage.

Queues, skills, wrap-up codes, canned responses and coverage.

## `canned_response_create`

**Create a canned response** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Creates a canned response. Careful: agents send its `text` to the organization's end customers, so write a message ready to send, with no internal data. `label` up to 80 chars, `text` up to 1000, `category` up to 40, `order` 0 to 999. The `id` is generated and returned. For safety the agent does not run it: because the text reaches customers, it returns a link to the admin screen (/admin/queue-settings) where a person confirms it.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | Yes |  |
| `label` | string | Yes |  |
| `text` | string | Yes |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `order` | integer | No |  |

## `canned_response_list`

**List canned responses** · Read only · Reached with `dakso_explore`

Lists canned responses (texts agents insert in the chat): `items` with `id`, `label`, `text`, `category`, `order` and `updatedAt`, and `total`. `category` filters by exact category.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | No |  |

## `canned_response_update`

**Update a canned response** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Edits a canned response by `id`; only what you pass is sent (label, text, category, order). Careful: agents send `text` to end customers, so a change reaches them at once. With `if_updated_at` (the `updatedAt` from the list), if someone changed it since, nothing is saved and it returns `stale: true`. Changing `text` is not run by the agent: it returns a link to the admin (/admin/queue-settings) for a person to confirm; label, category and order are edited here.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes |  |
| `category` | string | No |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `if_updated_at` | string | No |  |
| `label` | string | No |  |
| `order` | integer | No |  |
| `text` | string | No |  |

## `queue_coverage`

**Check queue coverage** · Read only · Reached with `dakso_explore`

Diagnoses queue coverage: per queue, `agents` (enabled agents serving it; one with empty `queues` counts for all), `flows` (flows active in prod that hand off to it) and `tools` (handoff tools using it). `unknownNames` are names someone uses that do not exist (usually a typo). `name` limits to one queue. Unreadable data appears in `unavailable` and as null, never 0. Queues chosen by expression are not counted.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | No |  |

## `queue_create`

**Create a queue** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Creates a support queue. `name` is unique in the organization (up to 64 chars). `acw` is the after-call work policy: {"mode": "optional" | "mandatory" | "timeboxed"}; timeboxed adds "timeoutSeconds" (15 to 900) and "defaultWrapupCode" (an existing wrap-up code that applies to the queue). Default is optional. If the queue exists, returns `created: false` and the existing one. Deleting a queue is done in the admin (/admin/queue-settings).

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes |  |
| `acw` | object | No |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `description` | string | No | Default: `""`. |

## `queue_dependents`

**Check what depends on a queue** · Read only · Reached with `dakso_explore`

Tells what depends on a queue before you touch it: `exists`, `agents`, `flows` and `tools`. Null = could not be read (`unavailable`). `partial: true` with `warnings` = the flow check is incomplete and an empty `flows` does not prove nobody depends on it. If `exists` is false, check the name.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes |  |

## `queue_list`

**List queues** · Read only · Reached with `dakso_explore`

Lists the organization's queues: `items` with `name`, `description`, `acw` (after-call work policy: mode, timeoutSeconds, defaultWrapupCode), `requireWrapupCode`, `createdAt` and `updatedAt` (copy it into `if_updated_at` when editing), and `total`.

No arguments.

## `queue_update`

**Update a queue** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Edits a queue by `name`; only what you pass is sent (`description` and/or `acw`). `if_updated_at` = the `updatedAt` from `queue_list` ("" if never edited): if someone changed the queue since, nothing is saved and it returns `stale: true` with the current queue.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes |  |
| `acw` | object | No |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `description` | string | No |  |
| `if_updated_at` | string | No |  |

## `skill_create`

**Create a skill** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Creates a skill by name (unique in the organization, up to 64 chars). If it already exists, returns `created: false` and the existing one.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Yes |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |

## `skill_list`

**List skills** · Read only · Reached with `dakso_explore`

Lists the organization's skills (abilities assigned to agents and queues): `items` with `name`, `description` and `createdAt`, and `total`.

No arguments.

## `wrapup_code_create`

**Create a wrap-up code** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Creates a wrap-up code. `code` is stored uppercase with only A-Z, 0-9 and _ (up to 40 chars) and is unique; `name` is what the agent sees (up to 80); `color` in hex; `queues` = names of the queues where it applies (empty or absent = all). If it exists, returns `created: false` and the existing one.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | Yes |  |
| `name` | string | Yes |  |
| `color` | string | No |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `description` | string | No | Default: `""`. |
| `queues` | array | No |  |

## `wrapup_code_list`

**List wrap-up codes** · Read only · Reached with `dakso_explore`

Lists wrap-up codes (how an agent classifies a conversation when it ends): `items` with `code`, `name`, `description`, `color`, `queues` (empty = applies to all queues) and `updatedAt`, and `total`. `queue` filters by one queue.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `queue` | string | No |  |

## `wrapup_code_update`

**Update a wrap-up code** · Changes data · can overwrite or remove · Reached with `dakso_explore`

Edits a wrap-up code by `code`; only what you pass is sent (name, description, color, queues; `queues=[]` makes it apply to all). It cannot be removed from a queue that uses it as the default code of a timeboxed after-call policy. With `if_updated_at` (the `updatedAt` from the list), if someone changed it since, nothing is saved and it returns `stale: true` with the current one.

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | Yes |  |
| `color` | string | No |  |
| `descripcion` | string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
| `description` | string | No |  |
| `if_updated_at` | string | No |  |
| `name` | string | No |  |
| `queues` | array | No |  |
