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

# Delete instruction

`DELETE /v2/instructions/{instruction_id}`

Deletes an instruction and all its associated configuration permanently.

:::warning
This action cannot be undone. Agents currently using this instruction may fail or behave unexpectedly. Update agents to use different instructions before deleting.
:::

## Path parameters

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

## Headers

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

## Response `204`

The instruction is deleted.

## Other responses

- `403` — Permissions do not allow deleting this instruction.
- `404` — Instruction not found.

---

[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/fca567a46b3a/schema)