Delete Instruction API Definition

The Delete Instruction API enables you to permanently remove a behavioral instruction from the Vectara platform. This is useful for decommissioning outdated instructions, cleaning up test environments, or revoking guidelines that are no longer needed.

Delete Instruction Request and Response

To delete an instruction, send a DELETE request to /v2/instructions/{instruction_id}. The instruction_id must be the unique identifier of the instruction you want to remove.

There is no request body. If the operation is successful, the API responds with a 204 No Content status, indicating that the instruction was removed.

Example Request

EXAMPLE REQUEST

Code example with bash syntax.bash

1

Example Response

EXAMPLE RESPONSE

Code example with http syntax.http

1

Error Responses

The API returns standard HTTP error codes with detailed error information:

HTTP Code	Error Code	Description
400	invalid_request	Invalid instruction_id format
401	unauthorized	Invalid or missing API key
403	forbidden	Insufficient permissions for deleting this instruction
404	not_found	Instruction with the specified ID does not exist
429	rate_limit_exceeded	Request rate limit exceeded