---
title: "Service Desk - create or update a canned response"
method: POST
path: "/ServiceDesk/CannedResponses"
tags: ["Servicedesk"]
---

# Service Desk - create or update a canned response

`POST /ServiceDesk/CannedResponses`

**Requires permission:** *IT*

Creates a snippet, or updates one the caller owns. Requires the IT permission.

## Request body

- PostServiceDeskCannedResponseRequest
  - `id` integer, nullable
  - `title` string, nullable
  - `folder` string, nullable
  - `body` string, nullable
  - `shared` boolean

## Response `200`

Success

- PostServiceDeskCannedResponseResponse
  - `cannedResponse` 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
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — Missing title or body
- `401` — Unauthorized
- `403` — Missing IT permission, or the response belongs to somebody else
- `404` — Canned response not found

---

[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)