Skip to main content
POST
Refine a built assistant's prompt

Authorizations

Authorization
string
header
required

Project API key (sk_api_…).

Path Parameters

assistantId
string<uuid>
required

The assistantId the original build returned.

Body

application/json
ownerFeedback
string
required

What to change, in plain language. Carried into every grading round, so a later automated fix cannot quietly undo it.

Maximum string length: 2000
brief
object

Replaces the brief the original build stored, for this run and every one after — send the whole brief, not just the fields you are changing. Omit to keep the stored brief.

Response

The refine started; nothing here reflects its outcome. A run that cannot start — because a build is already in flight for this assistant — still returns 200, and surfaces as failed in the status poll.

buildId
string<uuid>

Identifies this build run, for the status poll.

assistantId
string<uuid>

The assistant being built.

status
enum<string>
Available options:
started