---
title: "Changes to Create Canary Deploy"
method: POST
path: "/ai/assistants/{assistant_id}/canary-deploys"
---

# Changes to Create Canary Deploy

`POST /ai/assistants/{assistant_id}/canary-deploys`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 89 revisions.

- **2026-10-15** `a72569d69430`: 1 breaking, 1 warning, 6 info
- **2026-05-08** `30cb1ddce91b`: 1 breaking, 1 warning, 2 info

## Changes

- **2026-10-15** `a72569d69430`: 1 breaking, 1 warning, 6 info
  - the response's body type changed from `object` to no type for status `422`
  - removed the optional property `detail` from the response with the `422` status
  - added the new optional `header` request parameter `Idempotency-Key`
  - added `#/components/schemas/HTTPValidationError, #/components/schemas/inference-embedding_ErrorResponse` to the response body `anyOf` list for the response status `422`
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - added the non-success response with the status `413`
  - added the non-success response with the status `503`
- **2026-05-08** `30cb1ddce91b`: 1 breaking, 1 warning, 2 info
  - removed the required property `versions` from the response with the `200` status
  - removed the request property `versions`
  - added the new optional request property `rules`
  - added the required property `rules` to the response with the `200` status

---

[Operation](https://skmtc.dev/team-telnyx/apis/telnyx-api/docs/ai/assistants/:assistant_id/canary-deploys/post.md) - [API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [Page](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/ai/assistants/:assistant_id/canary-deploys/post)
