List prompt versions

GET/v1/prompts/{slug}/versions

List prompt versions.

Returns every version of the prompt, newest first, without their messages. Requires membership of the prompt's workspace (organization admins have it). 404 when the prompt does not exist.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Path parameters

slugstringrequired
the prompt's slug

Query parameters

organizationstringrequired
slug of the organization that owns it

Responses

200application/json

prompt_slugstring
Slug of the prompt.
dataobject[]
The versions, without their content.
Child attributes
- idstring
  The version's unique id (UUID).
- prompt_idstring
  Id (UUID) of the prompt the version belongs to.
- version_numberinteger<int32>
  The version's number within the prompt, from 1.
- statusenum<string>
  Lifecycle state: DRAFT (saved, never published), PUBLISHED (the prompt's published version; at most one at a time) or ARCHIVED (was the published version until another version was published).
  One of "DRAFT", "PUBLISHED", "ARCHIVED"
- labelsstring[]
  Labels currently pointing at this version, for example production. Empty when none.
- modelstring
  The model completions use, for example gpt-4o. Null when none was set: a completion or test run must then send model_override.
- created_atstring<date-time>
  When the version was saved (ISO 8601).
- created_bystring
  Identifier of the caller (user or API key) that saved the version, or unknown when the caller could not be identified.

VectorAxis is built by GK Labs, a member of NVIDIA Inception.