curl --request GET \
--url https://api.galtea.ai/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.galtea.ai/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.galtea.ai/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.galtea.ai/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.galtea.ai/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.galtea.ai/versions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "ver_123",
"productId": "prod_123",
"userId": "user_123",
"number": 7,
"name": "support release",
"description": "Version description",
"modelId": "model_123",
"systemPrompt": "You are a helpful assistant",
"datasetUri": "https://example.com/dataset.csv",
"datasetDescription": "Training dataset",
"guardrails": "Safety guidelines",
"facts": {
"model": "gpt-4o",
"temperature": "0.7",
"promptVersion": "12"
},
"otelInputSourceRule": {
"spanName": "ExecuteActivity:add_user_message",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "user"
}
},
"otelOutputSourceRule": {
"spanName": "ExecuteActivity:save_reply",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "assistant"
}
},
"initializationEndpointConnectionId": "ec_123",
"conversationEndpointConnectionId": "ec_123",
"finalizationEndpointConnectionId": "ec_123",
"phoneConnectionId": "phoneConnection_123",
"webRtcConnectionId": "webRtcConnection_123",
"parentVersionId": "ver_122",
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
]{
"error": "Error type",
"message": "Error message description"
}Get versions
Get list of versions with pagination and filtering options. See Versions.
curl --request GET \
--url https://api.galtea.ai/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.galtea.ai/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.galtea.ai/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.galtea.ai/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.galtea.ai/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.galtea.ai/versions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "ver_123",
"productId": "prod_123",
"userId": "user_123",
"number": 7,
"name": "support release",
"description": "Version description",
"modelId": "model_123",
"systemPrompt": "You are a helpful assistant",
"datasetUri": "https://example.com/dataset.csv",
"datasetDescription": "Training dataset",
"guardrails": "Safety guidelines",
"facts": {
"model": "gpt-4o",
"temperature": "0.7",
"promptVersion": "12"
},
"otelInputSourceRule": {
"spanName": "ExecuteActivity:add_user_message",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "user"
}
},
"otelOutputSourceRule": {
"spanName": "ExecuteActivity:save_reply",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "assistant"
}
},
"initializationEndpointConnectionId": "ec_123",
"conversationEndpointConnectionId": "ec_123",
"finalizationEndpointConnectionId": "ec_123",
"phoneConnectionId": "phoneConnection_123",
"webRtcConnectionId": "webRtcConnection_123",
"parentVersionId": "ver_122",
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
]{
"error": "Error type",
"message": "Error message description"
}Authorizations
API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....
Query Parameters
Filter by version IDs
Filter by product IDs
Filter by model IDs (the model assigned to the version)
Filter by parent version IDs. Returns the revisions whose parent is one of these versions (the versions revised from them).
Filter by conversation endpoint connection IDs (include only). Use an empty string ("") to select versions without a conversation endpoint connection
Omit versions with the specified conversation endpoint connection IDs. Use an empty string ("") to omit versions without a conversation endpoint connection
Filter by phone connection IDs (include only). Use an empty string ("") to select versions without a phone connection
Omit versions with the specified phone connection IDs. Use an empty string ("") to omit versions without a phone connection
Filter by WebRTC connection IDs (include only). Use an empty string ("") to select versions without a WebRTC connection
Omit versions with the specified WebRTC connection IDs. Use an empty string ("") to omit versions without a WebRTC connection
Filter by version names (exact match, multiple)
Filter by version name (partial match)
Filter versions that have evaluations
Filter versions that have traces
Sort instructions (field and direction pairs)
Maximum number of results
Number of results to skip
Filter versions created at or after this timestamp (ISO 8601 format)
Filter versions created at or before this timestamp (ISO 8601 format)
Response
Versions retrieved successfully
"ver_123"
"prod_123"
"user_123"
The version's sequence number inside its product. It starts at 1, is assigned when the version is created, never changes, and is never reused after a version is deleted. The canonical label is "v" followed by this number.
x >= 17
Optional human label. Omit it and the version is stored under its canonical label. A name of "v" followed by digits is rejected, because it reads as the number of another version. The one exception is the number this version is given, which produces the same result as omitting the name. "v1.0" is accepted.
"support release"
"Version description"
"model_123"
"You are a helpful assistant"
"https://example.com/dataset.csv"
"Training dataset"
"Safety guidelines"
The agent state this version represents, as a flat map of text to text. Every key and every value is trimmed, an entry whose key or value is then empty is dropped, and the rest is kept exactly, so "0.7" and "0.70" are two different facts. At most 32 keys, and at most 2000 bytes once the map is encoded as JSON, which counts its punctuation too. No key and no value may hold the NUL character or half of a surrogate pair. Two keys that become equal after the spaces around them are removed are refused, unless both become empty, which drops them instead because a blank key names no fact; a key repeated with the exact same spelling never reaches that rule, because JSON parsing keeps only its last value. Two live versions of one product may not hold the same facts; the key order you send does not change that comparison. A map that leaves no entry is stored as null.
Show child attributes
Show child attributes
{
"model": "gpt-4o",
"temperature": "0.7",
"promptVersion": "12"
}
Recover a turn's user-visible input for products whose user message lives on a non-LLM span. Set per product or version (version wins). Per span it applies only when no LLM input is present. Per turn the value it extracts IS the turn input, ahead of every fallback, and the turn input is EMPTY when the rule extracts nothing from any span of the turn. The two directions resolve independently.
Show child attributes
Show child attributes
{
"spanName": "ExecuteActivity:add_user_message",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "user"
}
}
Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per product or version (version wins). Per span it applies only when no LLM output is present. Per turn the value it extracts IS the turn output, ahead of every fallback, and the turn output is EMPTY when the rule extracts nothing from any span of the turn. The two directions resolve independently.
Show child attributes
Show child attributes
{
"spanName": "ExecuteActivity:save_reply",
"attribute": "app.arguments",
"path": "$[0].message.content",
"predicate": {
"path": "$[0].message.role",
"equals": "assistant"
}
}
"ec_123"
"ec_123"
"ec_123"
The version's phone connection (telephony conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.
"phoneConnection_123"
The version's WebRTC connection (live two-way audio conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.
"webRtcConnection_123"
Id of the version this one was revised from (its direct parent in the revision lineage). On create, providing this value records the parent edge; the parent must belong to the same product. Omit or null to create a root version with no parent. On responses, this is the recorded parent edge (null for roots).
"ver_122"