---
title: "Delete instruction version"
method: DELETE
path: "/v2/instructions/{instruction_id}/versions/{version}"
tags: ["Instructions"]
---

# Delete instruction version

`DELETE /v2/instructions/{instruction_id}/versions/{version}`

Deletes the specified version of the instruction permanently. This action cannot be undone.

## Path parameters

- `instruction_id` string, required — The unique identifier for an instruction.
- `version` integer, required

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `204`

The instruction version is deleted.

## Other responses

- `403` — Permissions do not allow deleting this instruction.
- `404` — Instruction not found.
- `409` — The specified version cannot be deleted because an agent uses it.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/e85040b266cc/schema)