v51

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-01308532588.1 KB
Prompts

Retrieve prompt versions by ids

Retrieve a batch of prompt versions by their ids. Typically used by the UI to resolve mask overlays.

post/v1/private/prompts/versions/retrieve-by-ids

Request body

idsstring[] required

Response

OK

idstring uuid

version unique identifier, generated if absent

prompt_idstring uuid
commitstring

version short unique identifier, generated if absent. it must be 8 characters long

version_numberstring

sequential version number in the format v<N>; null for masks

templatestring required
metadataJsonNodeDetail
type'mustache' | 'jinja2' | 'python'
version_type'prompt_version' | 'mask'

version type discriminator; defaults to prompt_version

environmentstring

Deprecated: use 'environments' instead

environmentsstring[]
change_descriptionstring
tagsstring[]
variablesstring[]
template_structure'text' | 'chat'
created_atstring date-time
created_bystring