Retrieve prompt versions by ids

POST

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

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

This endpoint expects an object.

idslist of stringsRequired

templatestring>=1 character

idstringOptionalformat: "uuid"

version unique identifier, generated if absent

prompt_idstringOptionalRead-onlyformat: "uuid"

commitstringOptionalformat: "^[a-zA-Z0-9]{8}$"

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

version_numberstringOptionalRead-only

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

metadataobjectOptional

typeenumOptional

version_typeenumOptional

version type discriminator; defaults to prompt_version

environmentslist of stringsOptional

change_descriptionstringOptional

tagslist of stringsOptional

variableslist of stringsOptionalRead-only

template_structureenumOptionalRead-only

created_atdatetimeOptionalRead-only

created_bystringOptionalRead-only

environmentstringOptionalformat: "^[A-Za-z0-9_-]+$"0-150 charactersDeprecated

Deprecated: use ‘environments’ instead

400

Bad Request Error

$	curl -X POST http://localhost:5173/api/v1/private/prompts/versions/retrieve-by-ids \
>	-H "Content-Type: application/json" \
>	-d '{
>	"ids": [
>	"string"
>	]
>	}'