Set labels on a prompt version
Set (replace) all labels on a prompt version. This is an idempotent operation. If a label already exists on another version of the same prompt, it will be moved to this version.
Labels not included in the request will be removed from this version.
Authorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Path Parameters
The unique prompt version identifier (base64) A universally unique identifier (base64-encoded opaque string).
"RW50aXR5OjEyMzQ1"
Body
Body containing the labels to set on a prompt version
Labels to set on a prompt version.
Array of label names to set on the version. Replaces all existing labels on this version. Pass an empty array to remove all labels from this version. Labels are unique per prompt — a label can only be assigned to one version at a time. If a label in this array is currently assigned to a different version of the same prompt, it will be moved to this version automatically (no error is raised).
Response
A prompt version object
A prompt version represents a specific snapshot of a prompt's configuration. Each version captures the messages, model settings, and parameters at a point in time. Versions are immutable once created and are identified by a commit hash.
The prompt version ID
The prompt ID this version belongs to
The commit hash of this version
The commit message describing the changes in this version
The messages that make up the prompt template
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 asF_STRING. Will be removed in a future version.
F_STRING, MUSTACHE, NONE The LLM provider to use
OPEN_AI, AZURE_OPEN_AI, AWS_BEDROCK, VERTEX_AI, ANTHROPIC, CUSTOM The model to use for the call
When the version was created
The user ID of the user who created this version
LLM invocation parameters for this version. When absent, no invocation parameters were set on this version.
Provider-specific parameters for this version. When absent, no provider-specific parameters were set on this version.
Label names currently pointing to this version (e.g., "production", "staging"). Labels are case-sensitive.