Sign in

v2

latestOpenAPI 3.0.3Apache-2.02026-08-07119359591.9 KB
Prompts

Resolve a label to a prompt version

Resolve a label on a prompt to the version it points to. Returns the full PromptVersion object that this label currently references.

<Note>This endpoint is in beta, read more here.</Note>

get/v2/prompts/{prompt_id}/labels/{label_name}

Path parameters

prompt_idstring required

A universally unique identifier (base64-encoded opaque string).

Example:RW50aXR5OjEyMzQ1

The unique prompt identifier (base64)

label_namestring required

The name of the label (e.g., "production", "staging")

Response

A prompt version object

idstring required

The prompt version ID

prompt_idstring required

The prompt ID this version belongs to

commit_hashstring required

The commit hash of this version

commit_messagestring required

The commit message describing the changes in this version

input_variable_format'F_STRING' | 'MUSTACHE' | 'NONE' required

The format for input variables in the prompt messages. Defaults to F_STRING if not provided.

  • F_STRING: Single curly braces ({variable_name})
  • MUSTACHE: Double curly braces ({{variable_name}})
  • NONE: Deprecated. Treated as F_STRING. Will be removed in a future version.
provider'OPEN_AI' | 'AZURE_OPEN_AI' | 'AWS_BEDROCK' | 'VERTEX_AI' | 'ANTHROPIC' | 'CUSTOM' required

The LLM provider to use

modelstring required

The model to use for the call

created_atstring date-time required

When the version was created

created_by_user_idstring required

The user ID of the user who created this version

labelsstring[]

Label names currently pointing to this version (e.g., "production", "staging"). Labels are case-sensitive.