---
title: "Service Desk - list canned responses"
method: GET
path: "/ServiceDesk/CannedResponses"
tags: ["Servicedesk"]
---

# Service Desk - list canned responses

`GET /ServiceDesk/CannedResponses`

**Requires permission:** *IT*

The caller's own snippets plus any shared by other agents, most-used first. Pass includeFreshservice=true to also mirror the helpdesk's read-only library, and ticketId to resolve merge fields against a real ticket. Requires the IT permission.

## Query parameters

- `includeFreshservice` boolean, nullable
- `ticketId` integer, nullable

## Response `200`

Success

- GetServiceDeskCannedResponsesResponse
  - `responses` ServiceDeskCannedResponse[]
    - `id` integer, nullable
    - `title` string, nullable
    - `folder` string, nullable
    - `body` string, nullable
    - `shared` boolean
    - `usageCount` integer
    - `lastUsed` string, date-time, nullable
    - `ownerEmail` string, nullable
    - `canEdit` boolean
    - `source` string, nullable
  - `placeholders` string[]
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `401` — Unauthorized
- `403` — Missing IT permission

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/4d9bcf62aa69/schema)