---
title: "Improve Prompt"
method: POST
path: "/v1/agents/improve-prompt"
tags: ["Agents"]
---

# Improve Prompt

`POST /v1/agents/improve-prompt`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/agents/improve-prompt`
- Auth: HTTP bearer

Use an LLM to rewrite / improve a user-provided agent prompt.

## Request body

- ImprovePromptRequest
  - `prompt` string, required
  - `context` 'conversation_prompt' | 'general_instructions' | 'sales_script' | 'business_description' | 'business_offer'

## Response `200`

Successful Response

- ImprovePromptResponse
  - `improved_prompt` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-28** `988a26cafef5`: 1 breaking
  - removed the enum value `filtering_prompt` of the request property `context`

[Operation history](https://skmtc.dev/orsay/apis/orsay-api/changes/v1/agents/improve-prompt/post.md)

---

[API](https://skmtc.dev/orsay/apis/orsay-api.md) - [All operations](https://skmtc.dev/orsay/apis/orsay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orsay/apis/orsay-api/revisions/988a26cafef5?raw)