---
title: "Enhance Assistant Instructions"
method: POST
path: "/ai/assistants/{assistant_id}/instructions/enhance"
tags: ["Assistants"]
---

# Enhance Assistant Instructions

`POST /ai/assistants/{assistant_id}/instructions/enhance`

Enhance an assistant's instructions using an LLM. The endpoint reads the assistant's current instructions and tools, then streams back improved instructions as they are generated.

Optionally provide an `enhancement_prompt` to steer the changes (for example, "make the instructions more concise" or "add error handling guidance"). When omitted, the assistant's existing instructions are used as the basis for the enhancement.

The enhancement focuses on tool-calling reliability, clarity and precision, completeness and error handling, tool schema alignment, and conversation flow structure.

The response is streamed as `text/plain` using chunked transfer encoding; consume the body incrementally to render the enhanced instructions as they arrive.

## Path parameters

- `assistant_id` string, required

## Request body

- EnhanceInstructionsRequest
  - `enhancement_prompt` string, nullable — Optional guidance describing how the instructions should be enhanced. When provided, the LLM applies these requested changes in addition to fixing any identified issues.
  - `instructions` string, nullable — The instructions to enhance. When omitted, the assistant's existing instructions are used.

## Response `200`

A stream of enhanced instruction text. The body is sent as `text/plain` using chunked transfer encoding.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/revisions/e32d46c5945b/schema)