prompts

Commit a prompt version

Commit the current draft version. This creates a readonly snapshot and advances the draft workflow.

post/api/prompts/{prompt_id}/commits/

Path parameters

prompt_idstring required

The unique prompt identifier.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Request body

descriptionstring

Optional commit message describing the changes.

Response

Committed version created.

idstring
prompt_version_idstring
versioninteger
descriptionstring nullable
messagesobject[]
modelstring
readonlyboolean
is_deployedboolean
created_atstring date-time
updated_atstring date-time

Changes