Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.
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-....
Body
application/json
productId
string
required
Product the version belongs to.
Minimum string length: 1
Example:
"prod_123"
facts
object
required
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. A fact whose key is "model" or "model_name" (case, "_" and "-" are ignored, so "modelName" counts too) is a model fact. It can link the version to the model whose name equals its value, provider prefix included (for example "azure/gpt-4o") and ignoring case. The model must be one the product organization can use: one of its own models or a global one. Its own model wins over a global model of the same name. Model facts that find two different models link none. At least one key and value must survive the trimming, or the call is refused. A version this call creates is linked to the model a model fact names; a version it finds keeps its model.
Name for the version, used only when this call creates one. A version the call finds keeps the name it already has. A name another version of the product holds is refused.
Example:
"nightly build"
Response
Version resolved successfully
id
string
Example:
"ver_123"
productId
string
Example:
"prod_123"
userId
string | null
Example:
"user_123"
number
integer
read-only
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.
Required range: x >= 1
Example:
7
name
string
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.
Example:
"support release"
description
string | null
Example:
"Version description"
modelId
string | null
The model the version runs on; token cost reads its prices. It must be one of the product organization's models or a global model. On a create, a modelId you send is the model; when you omit it or send null or an empty string, a model fact links the model (see facts). On an update, a model fact links the model only when you omit modelId and the version has no model; null clears the model.
Example:
"model_123"
systemPrompt
string | null
Example:
"You are a helpful assistant"
datasetUri
string | null
Example:
"https://example.com/dataset.csv"
datasetDescription
string | null
Example:
"Training dataset"
guardrails
string | null
Example:
"Safety guidelines"
facts
object | null
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. A fact whose key is "model" or "model_name" (case, "_" and "-" are ignored, so "modelName" counts too) is a model fact. It can link the version to the model whose name equals its value, provider prefix included (for example "azure/gpt-4o") and ignoring case. The model must be one the product organization can use: one of its own models or a global one. Its own model wins over a global model of the same name. Model facts that find two different models link none.
Recover a turn's user-visible input for products whose user message lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.
Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.
The version's phone connection (telephony conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.
Example:
"phoneConnection_123"
webRtcConnectionId
string | null
The version's WebRTC connection (live two-way audio conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.
Example:
"webRtcConnection_123"
parentVersionId
string | null
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).
Example:
"ver_122"
createdAt
string<date-time>
deletedAt
string<date-time> | null
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Galtea Docs","colors":{"primary":"#5286FF","light":"#A9E3FE","dark":"#171717"},"logo":{"light":"https://mintcdn.com/galtea/t4BZ_SsOYjDJqfd8/logo/light.svg?fit=max\u0026auto=format\u0026n=t4BZ_SsOYjDJqfd8\u0026q=85\u0026s=52a5941e3fa4d5af453da96cfa8d07e5","dark":"https://mintcdn.com/galtea/t4BZ_SsOYjDJqfd8/logo/dark.svg?fit=max\u0026auto=format\u0026n=t4BZ_SsOYjDJqfd8\u0026q=85\u0026s=0ea251446a97e2cd0bb0e9de1b049412"},"favicon":"https://mintcdn.com/galtea/sKxmtq77X98SiOSi/favicon.png?fit=max\u0026auto=format\u0026n=sKxmtq77X98SiOSi\u0026q=85\u0026s=a297a4f88e5dd07d7858dc2998dfe3ce","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#f6f6f5","dark":"#09090a"}},"navbar":{"links":[{"href":"mailto:support@galtea.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.galtea.ai"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/galtea-ai","website":"https://galtea.ai"}},"fonts":{"family":"Geist"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":true},"integrations":{"posthog":{"apiKey":"phc_5hcYhBTteqSv1mp9ObS5j28EKEA1HV6sog9EZHikgcF","apiHost":"https://t.galtea.ai","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://galtea.ai/blog"},{"anchor":"Changelog","icon":"list-check","href":"https://docs.galtea.ai/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"galtea","hasAudioNarration":false,"actualSubdomain":"galtea","customDomains":["docs.galtea.ai"],"gitSource":{"type":"github","owner":"galtea-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc354e44ba07be7352fb3b","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Concepts","count":3896},{"language":"default","tag":"REST API","count":1987},{"language":"default","tag":"Endpoints","count":1760},{"language":"default","tag":"SDK","count":1413},{"language":"default","tag":"Metrics","count":387},{"language":"default","tag":"Guides","count":330},{"language":"default","tag":"Deployment","count":180},{"language":"default","tag":"evaluations","count":180},{"language":"default","tag":"monitors","count":180},{"language":"default","tag":"metrics","count":177}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"v5.16/api-reference/versions/get-or-create-version-by-facts","slug":"/v5.16/api-reference/versions/get-or-create-version-by-facts","pageMetadata":{"title":"Get or create version by facts","description":"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /versions/get-or-create","href":"/v5.16/api-reference/versions/get-or-create-version-by-facts","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsx(Warning,{children:_jsxs(_components.p,{children:[`You are reading the docs of Galtea 5.16. `,_jsx(_components.a,{href:`/api-reference/versions/get-or-create-version-by-facts`,children:`Read this page in the latest version`}),`.`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get or create version by facts","description":"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /versions/get-or-create","href":"/v5.16/api-reference/versions/get-or-create-version-by-facts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/galtea/d232846d89fbe5a1/galtea-assistant.js"],"openApiReferenceData":{"operation":{"operationId":"getOrCreateVersion","tags":["versions"],"summary":"Get or create version by facts","description":"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.","security":["61615506-2395-4fd5-9d5e-95b1518491f7"],"x-cli-name":"get-or-create","requestBody":"7fdc8466-6764-4e35-84d6-7077eaf6f525","responses":{"200":"52beed6c-56da-406d-91b7-f3c5b81ca1bd","400":"0c29e6b9-7faf-4d58-9f21-0f7e9bd7b2f3","401":"46522899-70f2-417a-be77-c092da614eb1","403":"ae090a5d-a749-4b5c-8aeb-291784e5066d","404":"13a0c933-6c71-4fa0-a86d-79c72940264a","409":"8afcbb79-853d-4fec-beb7-05b6e7daeb0f","429":"2d7b5ac0-2cf1-42a7-ad3b-d55c1c31c2a8"},"x-mint":{"content":"\u003cWarning>\n You are reading the docs of Galtea 5.16. [Read this page in the latest version](/api-reference/versions/get-or-create-version-by-facts).\n\u003c/Warning>\n"},"method":"post","type":"path","servers":["a27193aa-51cc-40ae-93dc-5bc31610c0ae"],"path":"/versions/get-or-create","baseUrlOptions":["https://api.galtea.ai"],"title":"Get or create version by facts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"example":"prod_123","description":"Product the version belongs to.","isRequired":true,"uniqueKey":"productId","typeLabel":"string"},"facts":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"facts.additionalProperties","typeLabel":"string"},"description":"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. A fact whose key is \"model\" or \"model_name\" (case, \"_\" and \"-\" are ignored, so \"modelName\" counts too) is a model fact. It can link the version to the model whose name equals its value, provider prefix included (for example \"azure/gpt-4o\") and ignoring case. The model must be one the product organization can use: one of its own models or a global one. Its own model wins over a global model of the same name. Model facts that find two different models link none. At least one key and value must survive the trimming, or the call is refused. A version this call creates is linked to the model a model fact names; a version it finds keeps its model.","example":{"model":"gpt-4o","temperature":"0.7","promptVersion":"12"},"isRequired":true,"uniqueKey":"facts","typeLabel":"object"},"name":{"type":"string","example":"nightly build","description":"Name for the version, used only when this call creates one. A version the call finds keeps the name it already has. A name another version of the product holds is refused.","uniqueKey":"name","typeLabel":"string"}},"required":["productId","facts"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"productId":"prod_123","facts":{"model":"gpt-4o","temperature":"0.7","promptVersion":"12"},"name":"nightly build"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"52beed6c-56da-406d-91b7-f3c5b81ca1bd":{"description":"Version resolved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"ver_123","uniqueKey":"id","typeLabel":"string"},"productId":{"type":"string","example":"prod_123","uniqueKey":"productId","typeLabel":"string"},"userId":{"oneOf":[{"type":"string","example":"user_123","uniqueKey":"userId.oneOf.0","typeLabel":"string"},{"type":"null","example":"user_123","uniqueKey":"userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"userId","typeLabel":"string | null"},"number":{"type":"integer","readOnly":true,"minimum":1,"example":7,"description":"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.","uniqueKey":"number","typeLabel":"integer"},"name":{"type":"string","example":"support release","description":"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.","uniqueKey":"name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","example":"Version description","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","example":"Version description","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"modelId":{"oneOf":[{"type":"string","example":"model_123","description":"The model the version runs on; token cost reads its prices. It must be one of the product organization's models or a global model. On a create, a modelId you send is the model; when you omit it or send null or an empty string, a model fact links the model (see facts). On an update, a model fact links the model only when you omit modelId and the version has no model; null clears the model.","uniqueKey":"modelId.oneOf.0","typeLabel":"string"},{"type":"null","example":"model_123","description":"The model the version runs on; token cost reads its prices. It must be one of the product organization's models or a global model. On a create, a modelId you send is the model; when you omit it or send null or an empty string, a model fact links the model (see facts). On an update, a model fact links the model only when you omit modelId and the version has no model; null clears the model.","uniqueKey":"modelId.oneOf.1","typeLabel":"null"}],"uniqueKey":"modelId","typeLabel":"string | null"},"systemPrompt":{"oneOf":[{"type":"string","example":"You are a helpful assistant","uniqueKey":"systemPrompt.oneOf.0","typeLabel":"string"},{"type":"null","example":"You are a helpful assistant","uniqueKey":"systemPrompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"systemPrompt","typeLabel":"string | null"},"datasetUri":{"oneOf":[{"type":"string","example":"https://example.com/dataset.csv","uniqueKey":"datasetUri.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://example.com/dataset.csv","uniqueKey":"datasetUri.oneOf.1","typeLabel":"null"}],"uniqueKey":"datasetUri","typeLabel":"string | null"},"datasetDescription":{"oneOf":[{"type":"string","example":"Training dataset","uniqueKey":"datasetDescription.oneOf.0","typeLabel":"string"},{"type":"null","example":"Training dataset","uniqueKey":"datasetDescription.oneOf.1","typeLabel":"null"}],"uniqueKey":"datasetDescription","typeLabel":"string | null"},"guardrails":{"oneOf":[{"type":"string","example":"Safety guidelines","uniqueKey":"guardrails.oneOf.0","typeLabel":"string"},{"type":"null","example":"Safety guidelines","uniqueKey":"guardrails.oneOf.1","typeLabel":"null"}],"uniqueKey":"guardrails","typeLabel":"string | null"},"facts":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"facts.oneOf.0.additionalProperties","typeLabel":"string"},"description":"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. A fact whose key is \"model\" or \"model_name\" (case, \"_\" and \"-\" are ignored, so \"modelName\" counts too) is a model fact. It can link the version to the model whose name equals its value, provider prefix included (for example \"azure/gpt-4o\") and ignoring case. The model must be one the product organization can use: one of its own models or a global one. Its own model wins over a global model of the same name. Model facts that find two different models link none.","example":{"model":"gpt-4o","temperature":"0.7","promptVersion":"12"},"uniqueKey":"facts.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"facts.oneOf.1.additionalProperties","typeLabel":"string"},"description":"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. A fact whose key is \"model\" or \"model_name\" (case, \"_\" and \"-\" are ignored, so \"modelName\" counts too) is a model fact. It can link the version to the model whose name equals its value, provider prefix included (for example \"azure/gpt-4o\") and ignoring case. The model must be one the product organization can use: one of its own models or a global one. Its own model wins over a global model of the same name. Model facts that find two different models link none.","example":{"model":"gpt-4o","temperature":"0.7","promptVersion":"12"},"uniqueKey":"facts.oneOf.1","typeLabel":"null"}],"uniqueKey":"facts","typeLabel":"object | null"},"otelInputSourceRule":{"oneOf":[{"type":"object","properties":{"spanName":{"type":"string","description":"Exact OTLP span name to match.","example":"ExecuteActivity:add_user_message","isRequired":true,"uniqueKey":"otelInputSourceRule.oneOf.0.spanName","typeLabel":"string"},"attribute":{"type":"string","description":"Span attribute key holding the JSON blob (string or object) to read.","example":"app.arguments","isRequired":true,"uniqueKey":"otelInputSourceRule.oneOf.0.attribute","typeLabel":"string"},"path":{"type":"string","description":"JSONPath into the parsed attribute value, resolving to the input text. Must start with the $ root.","example":"$[0].message.content","isRequired":true,"uniqueKey":"otelInputSourceRule.oneOf.0.path","typeLabel":"string"},"predicate":{"oneOf":[{"type":"object","properties":{"path":{"type":"string","example":"$[0].message.role","isRequired":true,"uniqueKey":"otelInputSourceRule.oneOf.0.predicate.oneOf.0.path","typeLabel":"string"},"equals":{"type":"string","example":"user","isRequired":true,"uniqueKey":"otelInputSourceRule.oneOf.0.predicate.oneOf.0.equals","typeLabel":"string"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals.","uniqueKey":"otelInputSourceRule.oneOf.0.predicate.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"user"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals.","uniqueKey":"otelInputSourceRule.oneOf.0.predicate.oneOf.1","typeLabel":"null"}],"uniqueKey":"otelInputSourceRule.oneOf.0.predicate","typeLabel":"object | null"}},"required":["spanName","attribute","path"],"description":"Recover a turn's user-visible input for products whose user message lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.","example":{"spanName":"ExecuteActivity:add_user_message","attribute":"app.arguments","path":"$[0].message.content","predicate":{"path":"$[0].message.role","equals":"user"}},"uniqueKey":"otelInputSourceRule.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"spanName":{"type":"string","description":"Exact OTLP span name to match.","example":"ExecuteActivity:add_user_message"},"attribute":{"type":"string","description":"Span attribute key holding the JSON blob (string or object) to read.","example":"app.arguments"},"path":{"type":"string","description":"JSONPath into the parsed attribute value, resolving to the input text. Must start with the $ root.","example":"$[0].message.content"},"predicate":{"oneOf":[{"type":"object","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"user"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals."},{"type":"null","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"user"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals."}]}},"required":["spanName","attribute","path"],"description":"Recover a turn's user-visible input for products whose user message lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.","example":{"spanName":"ExecuteActivity:add_user_message","attribute":"app.arguments","path":"$[0].message.content","predicate":{"path":"$[0].message.role","equals":"user"}},"uniqueKey":"otelInputSourceRule.oneOf.1","typeLabel":"null"}],"uniqueKey":"otelInputSourceRule","typeLabel":"object | null"},"otelOutputSourceRule":{"oneOf":[{"type":"object","properties":{"spanName":{"type":"string","description":"Exact OTLP span name to match.","example":"ExecuteActivity:save_reply","isRequired":true,"uniqueKey":"otelOutputSourceRule.oneOf.0.spanName","typeLabel":"string"},"attribute":{"type":"string","description":"Span attribute key holding the JSON blob (string or object) to read.","example":"app.arguments","isRequired":true,"uniqueKey":"otelOutputSourceRule.oneOf.0.attribute","typeLabel":"string"},"path":{"type":"string","description":"JSONPath into the parsed attribute value, resolving to the output text. Must start with the $ root.","example":"$[0].message.content","isRequired":true,"uniqueKey":"otelOutputSourceRule.oneOf.0.path","typeLabel":"string"},"predicate":{"oneOf":[{"type":"object","properties":{"path":{"type":"string","example":"$[0].message.role","isRequired":true,"uniqueKey":"otelOutputSourceRule.oneOf.0.predicate.oneOf.0.path","typeLabel":"string"},"equals":{"type":"string","example":"assistant","isRequired":true,"uniqueKey":"otelOutputSourceRule.oneOf.0.predicate.oneOf.0.equals","typeLabel":"string"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals.","uniqueKey":"otelOutputSourceRule.oneOf.0.predicate.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"assistant"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals.","uniqueKey":"otelOutputSourceRule.oneOf.0.predicate.oneOf.1","typeLabel":"null"}],"uniqueKey":"otelOutputSourceRule.oneOf.0.predicate","typeLabel":"object | null"}},"required":["spanName","attribute","path"],"description":"Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.","example":{"spanName":"ExecuteActivity:save_reply","attribute":"app.arguments","path":"$[0].message.content","predicate":{"path":"$[0].message.role","equals":"assistant"}},"uniqueKey":"otelOutputSourceRule.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"spanName":{"type":"string","description":"Exact OTLP span name to match.","example":"ExecuteActivity:save_reply"},"attribute":{"type":"string","description":"Span attribute key holding the JSON blob (string or object) to read.","example":"app.arguments"},"path":{"type":"string","description":"JSONPath into the parsed attribute value, resolving to the output text. Must start with the $ root.","example":"$[0].message.content"},"predicate":{"oneOf":[{"type":"object","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"assistant"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals."},{"type":"null","properties":{"path":{"type":"string","example":"$[0].message.role"},"equals":{"type":"string","example":"assistant"}},"required":["path","equals"],"description":"Optional gate: apply the rule only when the node at predicate.path equals predicate.equals."}]}},"required":["spanName","attribute","path"],"description":"Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per organization, product or version. The version rule wins, then the product rule. 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.","example":{"spanName":"ExecuteActivity:save_reply","attribute":"app.arguments","path":"$[0].message.content","predicate":{"path":"$[0].message.role","equals":"assistant"}},"uniqueKey":"otelOutputSourceRule.oneOf.1","typeLabel":"null"}],"uniqueKey":"otelOutputSourceRule","typeLabel":"object | null"},"initializationEndpointConnectionId":{"oneOf":[{"type":"string","example":"ec_123","uniqueKey":"initializationEndpointConnectionId.oneOf.0","typeLabel":"string"},{"type":"null","example":"ec_123","uniqueKey":"initializationEndpointConnectionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"initializationEndpointConnectionId","typeLabel":"string | null"},"conversationEndpointConnectionId":{"oneOf":[{"type":"string","example":"ec_123","uniqueKey":"conversationEndpointConnectionId.oneOf.0","typeLabel":"string"},{"type":"null","example":"ec_123","uniqueKey":"conversationEndpointConnectionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversationEndpointConnectionId","typeLabel":"string | null"},"finalizationEndpointConnectionId":{"oneOf":[{"type":"string","example":"ec_123","uniqueKey":"finalizationEndpointConnectionId.oneOf.0","typeLabel":"string"},{"type":"null","example":"ec_123","uniqueKey":"finalizationEndpointConnectionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"finalizationEndpointConnectionId","typeLabel":"string | null"},"phoneConnectionId":{"oneOf":[{"type":"string","description":"The version's phone connection (telephony conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.","example":"phoneConnection_123","uniqueKey":"phoneConnectionId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The version's phone connection (telephony conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.","example":"phoneConnection_123","uniqueKey":"phoneConnectionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"phoneConnectionId","typeLabel":"string | null"},"webRtcConnectionId":{"oneOf":[{"type":"string","description":"The version's WebRTC connection (live two-way audio conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.","example":"webRtcConnection_123","uniqueKey":"webRtcConnectionId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The version's WebRTC connection (live two-way audio conversation target). At most one conversation target may be set across conversationEndpointConnectionId, phoneConnectionId, and webRtcConnectionId.","example":"webRtcConnection_123","uniqueKey":"webRtcConnectionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"webRtcConnectionId","typeLabel":"string | null"},"parentVersionId":{"oneOf":[{"type":"string","example":"ver_122","description":"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).","uniqueKey":"parentVersionId.oneOf.0","typeLabel":"string"},{"type":"null","example":"ver_122","description":"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).","uniqueKey":"parentVersionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"parentVersionId","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"deletedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"deletedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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"}}},"exampleType":"generated"}},"exampleType":"generated"},"0c29e6b9-7faf-4d58-9f21-0f7e9bd7b2f3":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"},"46522899-70f2-417a-be77-c092da614eb1":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"},"ae090a5d-a749-4b5c-8aeb-291784e5066d":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"},"13a0c933-6c71-4fa0-a86d-79c72940264a":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"},"8afcbb79-853d-4fec-beb7-05b6e7daeb0f":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"},"2d7b5ac0-2cf1-42a7-ad3b-d55c1c31c2a8":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error type","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","example":"Error message description","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error type","message":"Error message description"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"61615506-2395-4fd5-9d5e-95b1518491f7":{"bearerAuth":{"type":"http","scheme":"bearer","description":"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-...`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"a27193aa-51cc-40ae-93dc-5bc31610c0ae":{"url":"https://api.galtea.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"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-...`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"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-...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"v5.16/openapi.json"},"subdomain":"galtea","siteName":"Galtea Docs","title":"Get or create version by facts - Galtea Docs","navMaps":{"firstHrefInVersion":{"5.18":{"href":"/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.17":{"href":"/v5.17/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.16":{"href":"/v5.16/api-reference/versions/get-or-create-version-by-facts","matchLevel":0},"5.15":{"href":"/v5.15/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.14":{"href":"/v5.14/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.13":{"href":"/v5.13/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.12":{"href":"/v5.12/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.11":{"href":"/v5.11/api-reference/versions/get-or-create-version-by-facts","matchLevel":1},"5.10":{"href":"/v5.10/api-reference/versions/get-or-create-version-by-facts","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T11:07:27.854Z","originalFileLocation":"v5.16/api-reference/versions/get-or-create-version-by-facts.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Galtea Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get or create version by facts - Galtea Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Galtea Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://galtea.mintlify.site/_mintlify/api/og/v2?division=versions\u0026amp;title=Get+or+create+version+by+facts\u0026amp;description=Answers+the+live+version+of+the+product+whose+facts+are+the+ones+you+send%2C+and+creates+it+when+no+version+holds+them.+Send+the+agent+state+you+are+about+to+test\u0026amp;theme=fd2f90730a25c88261e3323d\u0026amp;signature=c76fa1c62dfc5c9bbdd3dc4d65e590a73dfc69ca6a1a9fcb2b33ebd92e7d35b3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get or create version by facts - Galtea Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://galtea.mintlify.site/_mintlify/api/og/v2?division=versions\u0026amp;title=Get+or+create+version+by+facts\u0026amp;description=Answers+the+live+version+of+the+product+whose+facts+are+the+ones+you+send%2C+and+creates+it+when+no+version+holds+them.+Send+the+agent+state+you+are+about+to+test\u0026amp;theme=fd2f90730a25c88261e3323d\u0026amp;signature=c76fa1c62dfc5c9bbdd3dc4d65e590a73dfc69ca6a1a9fcb2b33ebd92e7d35b3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/galtea/uhYCG_Ntu-v3eoIp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Galtea Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5286FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v5.16/api-reference/versions/get-or-create-version-by-facts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.galtea.ai/#organization\",\"name\":\"Galtea Docs\",\"url\":\"https://docs.galtea.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/galtea/t4BZ_SsOYjDJqfd8/logo/light.svg?fit=max\u0026auto=format\u0026n=t4BZ_SsOYjDJqfd8\u0026q=85\u0026s=52a5941e3fa4d5af453da96cfa8d07e5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.galtea.ai#website\",\"name\":\"Galtea Docs\",\"url\":\"https://docs.galtea.ai\",\"publisher\":{\"@id\":\"https://docs.galtea.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts#webpage\",\"url\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts\",\"name\":\"Get or create version by facts\",\"description\":\"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\",\"dateModified\":\"2026-11-17T11:07:27.854Z\",\"isPartOf\":{\"@id\":\"https://docs.galtea.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.galtea.ai/v5.16/api-reference/health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"versions\",\"item\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-versions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get or create version by facts\",\"item\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts#apireference\",\"headline\":\"Get or create version by facts\",\"name\":\"Get or create version by facts\",\"description\":\"Answers the live version of the product whose facts are the ones you send, and creates it when no version holds them. Send the agent state you are about to test, and callers that run at the same time on that state all receive one version instead of each creating its own. The key order you send does not change the match. The answer is 200 whether the version already existed or was created now, because the caller asks for the version for a state and not for a new row.\",\"url\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.galtea.ai/v5.16/api-reference/versions/get-or-create-version-by-facts#webpage\"},\"dateModified\":\"2026-11-17T11:07:27.854Z\",\"publisher\":{\"@id\":\"https://docs.galtea.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.galtea.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Galtea Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Galtea Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v5.16/api-reference/versions/get-or-create-version-by-facts.md","siteName":"Galtea Docs","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://galtea.ai/blog"},{"anchor":"Changelog","icon":"list-check","href":"https://docs.galtea.ai/changelog"}]},"versions":[{"version":"5.18","default":true,"tag":"Latest","pages":[{"title":"5.18","href":"/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.17","pages":[{"title":"5.17","href":"/v5.17/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.16","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/v5.16/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/v5.16/concepts/overview"}]},{"tab":"Deployment","pages":[{"title":"Deployment","href":"/v5.16/deployment/executive-summary"}]},{"tab":"REST API","groups":[{"group":"Overview","pages":[{"title":"Write responses","icon":"reply","href":"/v5.16/api-reference/write-responses"},{"title":"Enum values","icon":"list","href":"/v5.16/api-reference/enum-values"}]},{"group":"Endpoints","pages":[{"group":"API Reference","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /health","href":"/v5.16/api-reference/health-check"},{"title":"Get minimum SDK version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /minimum-sdk-version","href":"/v5.16/api-reference/get-minimum-sdk-version"},{"title":"Build info","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /build-info","href":"/v5.16/api-reference/build-info"},{"title":"Build info for every deployed service","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /build-info/services","href":"/v5.16/api-reference/build-info-for-every-deployed-service"},{"title":"Platform compatibility","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /platform-compatibility","href":"/v5.16/api-reference/platform-compatibility"},{"title":"Whether every deployed service can reach its dependencies","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /self-check","href":"/v5.16/api-reference/whether-every-deployed-service-can-reach-its-dependencies"}]},{"group":"api-tokens","pages":[{"title":"List API tokens","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /auth/apiTokens","href":"/v5.16/api-reference/api-tokens/list-api-tokens"},{"title":"Create API token","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /auth/apiTokens","href":"/v5.16/api-reference/api-tokens/create-api-token"},{"title":"Revoke API token","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /auth/apiTokens/{apiTokenId}","href":"/v5.16/api-reference/api-tokens/revoke-api-token"},{"title":"Rename API token","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /auth/apiTokens/{apiTokenId}","href":"/v5.16/api-reference/api-tokens/rename-api-token"},{"title":"Regenerate API token","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /auth/apiTokens/{apiTokenId}/regenerate","href":"/v5.16/api-reference/api-tokens/regenerate-api-token"}]},{"group":"auth","pages":[{"title":"Get current user","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /auth/user","href":"/v5.16/api-reference/auth/get-current-user"}]},{"group":"organizations","pages":[{"title":"Get organizations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /organizations","href":"/v5.16/api-reference/organizations/get-organizations"},{"title":"Get organization by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /organizations/{id}","href":"/v5.16/api-reference/organizations/get-organization-by-id"},{"title":"Update organization","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /organizations/{id}","href":"/v5.16/api-reference/organizations/update-organization"},{"title":"Get credit status","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /organizations/{id}/creditStatus","href":"/v5.16/api-reference/organizations/get-credit-status"}]},{"group":"user-groups","pages":[{"title":"Get user groups","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /userGroups","href":"/v5.16/api-reference/user-groups/get-user-groups"},{"title":"Create user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /userGroups","href":"/v5.16/api-reference/user-groups/create-user-group"},{"title":"Link users to user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /userGroups/{id}/users","href":"/v5.16/api-reference/user-groups/link-users-to-user-group"},{"title":"Unlink users from user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /userGroups/{id}/users","href":"/v5.16/api-reference/user-groups/unlink-users-from-user-group"},{"title":"Delete multiple user groups","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /userGroups/batch","href":"/v5.16/api-reference/user-groups/delete-multiple-user-groups"},{"title":"Get user group by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /userGroups/{id}","href":"/v5.16/api-reference/user-groups/get-user-group-by-id"},{"title":"Delete user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /userGroups/{id}","href":"/v5.16/api-reference/user-groups/delete-user-group"},{"title":"Update user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /userGroups/{id}","href":"/v5.16/api-reference/user-groups/update-user-group"},{"title":"List grantable user group permissions","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /userGroups/grantablePermissions","href":"/v5.16/api-reference/user-groups/list-grantable-user-group-permissions"},{"title":"Link metrics to user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /userGroups/{id}/metrics","href":"/v5.16/api-reference/user-groups/link-metrics-to-user-group"},{"title":"Unlink metrics from user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /userGroups/{id}/metrics","href":"/v5.16/api-reference/user-groups/unlink-metrics-from-user-group"},{"title":"Link products to user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /userGroups/{id}/products","href":"/v5.16/api-reference/user-groups/link-products-to-user-group"},{"title":"Unlink products from user group","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /userGroups/{id}/products","href":"/v5.16/api-reference/user-groups/unlink-products-from-user-group"}]},{"group":"metrics","pages":[{"title":"Get metrics","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics","href":"/v5.16/api-reference/metrics/get-metrics"},{"title":"Create metric","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics","href":"/v5.16/api-reference/metrics/create-metric"},{"title":"Create multiple metrics","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/batch","href":"/v5.16/api-reference/metrics/create-multiple-metrics"},{"title":"Delete multiple metrics","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /metrics/batch","href":"/v5.16/api-reference/metrics/delete-multiple-metrics"},{"title":"Get metric by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics/{id}","href":"/v5.16/api-reference/metrics/get-metric-by-id"},{"title":"Delete metric","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /metrics/{id}","href":"/v5.16/api-reference/metrics/delete-metric"},{"title":"Update metric","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /metrics/{id}","href":"/v5.16/api-reference/metrics/update-metric"},{"title":"Count replay candidates per product for a metric revision","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics/{id}/replay-candidate-count","href":"/v5.16/api-reference/metrics/count-replay-candidates-per-product-for-a-metric-revision"},{"title":"Generate or complete metric configuration with AI","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/generate-config","href":"/v5.16/api-reference/metrics/generate-or-complete-metric-configuration-with-ai"},{"title":"Preview the prompt a judge configuration produces","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/preview-prompt","href":"/v5.16/api-reference/metrics/preview-the-prompt-a-judge-configuration-produces"},{"title":"Score a draft Classifier question on a sample","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/test-draft","href":"/v5.16/api-reference/metrics/score-a-draft-classifier-question-on-a-sample"},{"title":"Create several Classifier metrics at once (classifier metrics only)","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/bulk","href":"/v5.16/api-reference/metrics/create-several-classifier-metrics-at-once-classifier-metrics-only"},{"title":"Propose Classifier metrics for an LLM judge metric","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/{id}/classifier-conversion","href":"/v5.16/api-reference/metrics/propose-classifier-metrics-for-an-llm-judge-metric"},{"title":"Export a metric revision as a document","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics/{id}/export","href":"/v5.16/api-reference/metrics/export-a-metric-revision-as-a-document"},{"title":"Get the analytics impact of a metric revision","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics/{id}/analytics-exclusion-impact","href":"/v5.16/api-reference/metrics/get-the-analytics-impact-of-a-metric-revision"},{"title":"Include or exclude a metric revision from analytics","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /metrics/{id}/analytics-exclusion","href":"/v5.16/api-reference/metrics/include-or-exclude-a-metric-revision-from-analytics"},{"title":"Get human annotation count and optimization eligibility","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /metrics/{id}/human-annotation-count","href":"/v5.16/api-reference/metrics/get-human-annotation-count-and-optimization-eligibility"},{"title":"Optimize metric","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/{id}/optimize","href":"/v5.16/api-reference/metrics/optimize-metric"},{"title":"Activate an optimized judge prompt","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/{id}/activate-optimization","href":"/v5.16/api-reference/metrics/activate-an-optimized-judge-prompt"},{"title":"Keep the current judge prompt over an optimized candidate","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/{id}/decline-optimization","href":"/v5.16/api-reference/metrics/keep-the-current-judge-prompt-over-an-optimized-candidate"},{"title":"Revise metric configuration with AI (Update With AI)","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /metrics/update-config","href":"/v5.16/api-reference/metrics/revise-metric-configuration-with-ai-update-with-ai"}]},{"group":"specifications","pages":[{"title":"Get specifications","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /specifications","href":"/v5.16/api-reference/specifications/get-specifications"},{"title":"Create specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /specifications","href":"/v5.16/api-reference/specifications/create-specification"},{"title":"Get specification by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /specifications/{id}","href":"/v5.16/api-reference/specifications/get-specification-by-id"},{"title":"Delete specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /specifications/{id}","href":"/v5.16/api-reference/specifications/delete-specification"},{"title":"Update specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /specifications/{id}","href":"/v5.16/api-reference/specifications/update-specification"},{"title":"Create multiple specifications","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /specifications/batch","href":"/v5.16/api-reference/specifications/create-multiple-specifications"},{"title":"Delete multiple specifications","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /specifications/batch","href":"/v5.16/api-reference/specifications/delete-multiple-specifications"},{"title":"Get linked metrics","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /specifications/{id}/metrics","href":"/v5.16/api-reference/specifications/get-linked-metrics"},{"title":"Link metrics to specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /specifications/{id}/metrics","href":"/v5.16/api-reference/specifications/link-metrics-to-specification"},{"title":"Unlink metrics from specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /specifications/{id}/metrics","href":"/v5.16/api-reference/specifications/unlink-metrics-from-specification"},{"title":"Get linked datasets","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /specifications/{id}/tests","href":"/v5.16/api-reference/specifications/get-linked-datasets"},{"title":"Link datasets to specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /specifications/{id}/tests","href":"/v5.16/api-reference/specifications/link-datasets-to-specification"},{"title":"Unlink datasets from specification","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /specifications/{id}/tests","href":"/v5.16/api-reference/specifications/unlink-datasets-from-specification"},{"title":"Generate specification configuration","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /specifications/generate-config","href":"/v5.16/api-reference/specifications/generate-specification-configuration"}]},{"group":"models","pages":[{"title":"Get models","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /models","href":"/v5.16/api-reference/models/get-models"},{"title":"Create model","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /models","href":"/v5.16/api-reference/models/create-model"},{"title":"Delete multiple models","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /models/batch","href":"/v5.16/api-reference/models/delete-multiple-models"},{"title":"Get model by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /models/{id}","href":"/v5.16/api-reference/models/get-model-by-id"},{"title":"Delete model","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /models/{id}","href":"/v5.16/api-reference/models/delete-model"},{"title":"Update model","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /models/{id}","href":"/v5.16/api-reference/models/update-model"}]},{"group":"products","pages":[{"title":"Get products","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /products","href":"/v5.16/api-reference/products/get-products"},{"title":"Create product","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /products","href":"/v5.16/api-reference/products/create-product"},{"title":"List distinct product tags","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /products/tags","href":"/v5.16/api-reference/products/list-distinct-product-tags"},{"title":"Delete multiple products","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /products/batch","href":"/v5.16/api-reference/products/delete-multiple-products"},{"title":"Get product by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /products/{id}","href":"/v5.16/api-reference/products/get-product-by-id"},{"title":"Delete product","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /products/{id}","href":"/v5.16/api-reference/products/delete-product"},{"title":"Update product","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /products/{id}","href":"/v5.16/api-reference/products/update-product"},{"title":"Generate product configuration using AI","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /products/generate-config","href":"/v5.16/api-reference/products/generate-product-configuration-using-ai"},{"title":"Cross-check a document against an existing product's specifications","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /products/{id}/regenerate-config","href":"/v5.16/api-reference/products/cross-check-a-document-against-an-existing-products-specifications"}]},{"group":"versions","pages":[{"title":"Get versions","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /versions","href":"/v5.16/api-reference/versions/get-versions"},{"title":"Create version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /versions","href":"/v5.16/api-reference/versions/create-version"},{"title":"Get version by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /versions/{id}","href":"/v5.16/api-reference/versions/get-version-by-id"},{"title":"Delete version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /versions/{id}","href":"/v5.16/api-reference/versions/delete-version"},{"title":"Update version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /versions/{id}","href":"/v5.16/api-reference/versions/update-version"},{"title":"List metrics annotated with compatibility for a version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /versions/{id}/compatible-metrics","href":"/v5.16/api-reference/versions/list-metrics-annotated-with-compatibility-for-a-version"},{"title":"Delete multiple versions","description":"Soft delete multiple versions by their IDs. See [Versions](https://docs.galtea.ai/concepts/product/version).","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /versions/batch","href":"/v5.16/api-reference/versions/delete-multiple-versions"},{"title":"Get or create version by facts","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /versions/get-or-create","href":"/v5.16/api-reference/versions/get-or-create-version-by-facts"}]},{"group":"monitors","pages":[{"title":"Get monitor results","description":"Aggregated results for a monitor over a trailing window (default 7 days, bucketed by day): per-metric-family sampling-weighted score series with 95% confidence intervals, the worst metric family, metric-revision and sampling-change markers, current-cycle credit spend, and the scored/waiting session listing. Below 30 scored sessions a bucket reports a collecting-data state instead of an interval. Computed only from the monitor's own evaluations.\n","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{id}/results","href":"/v5.16/api-reference/monitors/get-monitor-results"},{"title":"Delete multiple monitors","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /monitors/batch","href":"/v5.16/api-reference/monitors/delete-multiple-monitors"},{"title":"Get monitor by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{id}","href":"/v5.16/api-reference/monitors/get-monitor-by-id"},{"title":"Delete monitor","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /monitors/{id}","href":"/v5.16/api-reference/monitors/delete-monitor"},{"title":"Update monitor","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /monitors/{id}","href":"/v5.16/api-reference/monitors/update-monitor"},{"title":"List a monitor's alert rules","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{monitorId}/alert-rules","href":"/v5.16/api-reference/monitors/list-a-monitors-alert-rules"},{"title":"Create a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{monitorId}/alert-rules","href":"/v5.16/api-reference/monitors/create-a-monitor-alert-rule"},{"title":"Get a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{monitorId}/alert-rules/{alertRuleId}","href":"/v5.16/api-reference/monitors/get-a-monitor-alert-rule"},{"title":"Delete a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /monitors/{monitorId}/alert-rules/{alertRuleId}","href":"/v5.16/api-reference/monitors/delete-a-monitor-alert-rule"},{"title":"Update a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /monitors/{monitorId}/alert-rules/{alertRuleId}","href":"/v5.16/api-reference/monitors/update-a-monitor-alert-rule"},{"title":"Pause a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{monitorId}/alert-rules/{alertRuleId}/pause","href":"/v5.16/api-reference/monitors/pause-a-monitor-alert-rule"},{"title":"Resume a monitor alert rule","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{monitorId}/alert-rules/{alertRuleId}/resume","href":"/v5.16/api-reference/monitors/resume-a-monitor-alert-rule"},{"title":"Regenerate an alert rule's webhook signing secret","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{monitorId}/alert-rules/{alertRuleId}/regenerate-webhook-secret","href":"/v5.16/api-reference/monitors/regenerate-an-alert-rules-webhook-signing-secret"},{"title":"List a monitor's alerts","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{monitorId}/alerts","href":"/v5.16/api-reference/monitors/list-a-monitors-alerts"},{"title":"Get a monitor alert","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors/{monitorId}/alerts/{alertId}","href":"/v5.16/api-reference/monitors/get-a-monitor-alert"},{"title":"Get monitors","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /monitors","href":"/v5.16/api-reference/monitors/get-monitors"},{"title":"Create monitor","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors","href":"/v5.16/api-reference/monitors/create-monitor"},{"title":"Preview monitor content-filter matches","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/preview","href":"/v5.16/api-reference/monitors/preview-monitor-content-filter-matches"},{"title":"Pause monitor","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{id}/pause","href":"/v5.16/api-reference/monitors/pause-monitor"},{"title":"Resume monitor","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /monitors/{id}/resume","href":"/v5.16/api-reference/monitors/resume-monitor"}]},{"group":"endpoint-connections","pages":[{"title":"Get endpoint connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /endpointConnections","href":"/v5.16/api-reference/endpoint-connections/get-endpoint-connections"},{"title":"Create endpoint connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /endpointConnections","href":"/v5.16/api-reference/endpoint-connections/create-endpoint-connection"},{"title":"Get endpoint connection by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /endpointConnections/{id}","href":"/v5.16/api-reference/endpoint-connections/get-endpoint-connection-by-id"},{"title":"Delete endpoint connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /endpointConnections/{id}","href":"/v5.16/api-reference/endpoint-connections/delete-endpoint-connection"},{"title":"Update endpoint connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /endpointConnections/{id}","href":"/v5.16/api-reference/endpoint-connections/update-endpoint-connection"},{"title":"Test endpoint connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /endpointConnections/testConnection","href":"/v5.16/api-reference/endpoint-connections/test-endpoint-connection"},{"title":"Parse a cURL command into endpoint connection fields","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /endpointConnections/parse-curl","href":"/v5.16/api-reference/endpoint-connections/parse-a-curl-command-into-endpoint-connection-fields"},{"title":"Delete multiple endpoint connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /endpointConnections/batch","href":"/v5.16/api-reference/endpoint-connections/delete-multiple-endpoint-connections"}]},{"group":"datasets","pages":[{"title":"Get dataset types used by the organization","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /tests/types","href":"/v5.16/api-reference/datasets/get-dataset-types-used-by-the-organization"},{"title":"Extend a generated dataset with more cases","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /tests/{id}/extend","href":"/v5.16/api-reference/datasets/extend-a-generated-dataset-with-more-cases"},{"title":"Create multiple datasets","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /tests/batch","href":"/v5.16/api-reference/datasets/create-multiple-datasets"},{"title":"Delete multiple datasets","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /tests/batch","href":"/v5.16/api-reference/datasets/delete-multiple-datasets"},{"title":"Get dataset by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /tests/{id}","href":"/v5.16/api-reference/datasets/get-dataset-by-id"},{"title":"Delete dataset","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /tests/{id}","href":"/v5.16/api-reference/datasets/delete-dataset"},{"title":"Update dataset","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /tests/{id}","href":"/v5.16/api-reference/datasets/update-dataset"},{"title":"Get datasets","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /tests","href":"/v5.16/api-reference/datasets/get-datasets"},{"title":"Create dataset","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /tests","href":"/v5.16/api-reference/datasets/create-dataset"},{"title":"Generate dataset configuration from specifications","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /tests/generate-config","href":"/v5.16/api-reference/datasets/generate-dataset-configuration-from-specifications"}]},{"group":"test-cases","pages":[{"title":"Get test cases","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /testCases","href":"/v5.16/api-reference/test-cases/get-test-cases"},{"title":"Create test case","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /testCases","href":"/v5.16/api-reference/test-cases/create-test-case"},{"title":"Get test case languages","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /testCases/languages","href":"/v5.16/api-reference/test-cases/get-test-case-languages"},{"title":"Export test cases as CSV","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /testCases/export","href":"/v5.16/api-reference/test-cases/export-test-cases-as-csv"},{"title":"Get test case by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /testCases/{id}","href":"/v5.16/api-reference/test-cases/get-test-case-by-id"},{"title":"Delete test case","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /testCases/{id}","href":"/v5.16/api-reference/test-cases/delete-test-case"},{"title":"Update test case","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /testCases/{id}","href":"/v5.16/api-reference/test-cases/update-test-case"},{"title":"Delete multiple test cases","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /testCases/batch","href":"/v5.16/api-reference/test-cases/delete-multiple-test-cases"},{"title":"Augment test cases","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /generateFromFewShot/augment","href":"/v5.16/api-reference/test-cases/augment-test-cases"},{"title":"Get augmentation task status","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /generateFromFewShot/status/{taskId}","href":"/v5.16/api-reference/test-cases/get-augmentation-task-status"},{"title":"Count replay candidates per product for a test case revision","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /testCases/{id}/replay-candidate-count","href":"/v5.16/api-reference/test-cases/count-replay-candidates-per-product-for-a-test-case-revision"}]},{"group":"sessions","pages":[{"title":"List metrics annotated with compatibility for a session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /sessions/{id}/compatible-metrics","href":"/v5.16/api-reference/sessions/list-metrics-annotated-with-compatibility-for-a-session"},{"title":"Get sessions","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /sessions","href":"/v5.16/api-reference/sessions/get-sessions"},{"title":"Create session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /sessions","href":"/v5.16/api-reference/sessions/create-session"},{"title":"Get session by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /sessions/{id}","href":"/v5.16/api-reference/sessions/get-session-by-id"},{"title":"Delete session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /sessions/{id}","href":"/v5.16/api-reference/sessions/delete-session"},{"title":"Update session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /sessions/{id}","href":"/v5.16/api-reference/sessions/update-session"},{"title":"Finish session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /sessions/{id}/finish","href":"/v5.16/api-reference/sessions/finish-session"},{"title":"Delete multiple sessions","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /sessions/batch","href":"/v5.16/api-reference/sessions/delete-multiple-sessions"},{"title":"Generate next user message","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /conversationSimulator/generateNextUserMessage","href":"/v5.16/api-reference/sessions/generate-next-user-message"},{"title":"Import sessions from a Langfuse trace export","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /sessions/import","href":"/v5.16/api-reference/sessions/import-sessions-from-a-langfuse-trace-export"}]},{"group":"traces","pages":[{"title":"Get traces","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /inferenceResults","href":"/v5.16/api-reference/traces/get-traces"},{"title":"Create trace","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /inferenceResults","href":"/v5.16/api-reference/traces/create-trace"},{"title":"Get aggregated performance data","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /inferenceResults/aggregatedData","href":"/v5.16/api-reference/traces/get-aggregated-performance-data"},{"title":"Get trace by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /inferenceResults/{id}","href":"/v5.16/api-reference/traces/get-trace-by-id"},{"title":"Delete trace","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /inferenceResults/{id}","href":"/v5.16/api-reference/traces/delete-trace"},{"title":"Update trace","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /inferenceResults/{id}","href":"/v5.16/api-reference/traces/update-trace"},{"title":"Create traces batch","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /inferenceResults/batch","href":"/v5.16/api-reference/traces/create-traces-batch"},{"title":"Delete multiple traces","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /inferenceResults/batch","href":"/v5.16/api-reference/traces/delete-multiple-traces"},{"title":"Generate traces from test cases","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /inferenceResults/generate","href":"/v5.16/api-reference/traces/generate-traces-from-test-cases"}]},{"group":"spans","pages":[{"title":"Get spans","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /traces","href":"/v5.16/api-reference/spans/get-spans"},{"title":"Create span","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /traces","href":"/v5.16/api-reference/spans/create-span"},{"title":"Get span by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /traces/{id}","href":"/v5.16/api-reference/spans/get-span-by-id"},{"title":"Delete span","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /traces/{id}","href":"/v5.16/api-reference/spans/delete-span"},{"title":"Create spans batch","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /traces/batch","href":"/v5.16/api-reference/spans/create-spans-batch"},{"title":"Delete multiple spans","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /traces/batch","href":"/v5.16/api-reference/spans/delete-multiple-spans"}]},{"group":"analytics","pages":[{"title":"Get analytics data","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics","href":"/v5.16/api-reference/analytics/get-analytics-data"},{"title":"Export analytics data","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /analytics/export","href":"/v5.16/api-reference/analytics/export-analytics-data"},{"title":"Get analytics insights for a version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/insights","href":"/v5.16/api-reference/analytics/get-analytics-insights-for-a-version"},{"title":"Get cross-version analytics comparison insights","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/insights/comparison","href":"/v5.16/api-reference/analytics/get-cross-version-analytics-comparison-insights"},{"title":"Get per-version scores and the newest version, per product","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/summary","href":"/v5.16/api-reference/analytics/get-per-version-scores-and-the-newest-version-per-product"},{"title":"List products with their session stats for a period","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/products","href":"/v5.16/api-reference/analytics/list-products-with-their-session-stats-for-a-period"},{"title":"Get the sessions of a period summed over products","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/sessions-overview","href":"/v5.16/api-reference/analytics/get-the-sessions-of-a-period-summed-over-products"},{"title":"Get the estimated cost of the sessions of a period summed over products","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/cost-overview","href":"/v5.16/api-reference/analytics/get-the-estimated-cost-of-the-sessions-of-a-period-summed-over-products"},{"title":"List the products whose share of critical failures went up","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/changes","href":"/v5.16/api-reference/analytics/list-the-products-whose-share-of-critical-failures-went-up"},{"title":"List the specifications that sessions failed in a period","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/failing-specifications","href":"/v5.16/api-reference/analytics/list-the-specifications-that-sessions-failed-in-a-period"},{"title":"Get the session outcomes of a product per day, week or month","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/session-outcomes-over-time","href":"/v5.16/api-reference/analytics/get-the-session-outcomes-of-a-product-per-day-week-or-month"},{"title":"Get the estimated cost per session of a product per day, week or month","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /analytics/session-cost-over-time","href":"/v5.16/api-reference/analytics/get-the-estimated-cost-per-session-of-a-product-per-day-week-or-month"}]},{"group":"storage","pages":[{"title":"Generate upload presigned URL","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /storage/generate-put-presigned-url","href":"/v5.16/api-reference/storage/generate-upload-presigned-url"},{"title":"Generate download presigned URL","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /storage/generate-get-presigned-url","href":"/v5.16/api-reference/storage/generate-download-presigned-url"}]},{"group":"jobs","pages":[{"title":"Get job status","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /jobs/{jobId}/status","href":"/v5.16/api-reference/jobs/get-job-status"},{"title":"Cancel a job","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /jobs/{jobId}/cancel","href":"/v5.16/api-reference/jobs/cancel-a-job"}]},{"group":"otel","pages":[{"title":"Validate credentials for OTel ingestion","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /otel/auth","href":"/v5.16/api-reference/otel/validate-credentials-for-otel-ingestion"},{"title":"Ingest OpenTelemetry spans (OTLP JSON)","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /otel/traces","href":"/v5.16/api-reference/otel/ingest-opentelemetry-spans-otlp-json"}]},{"group":"phone-connections","pages":[{"title":"Get phone connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /phoneConnections","href":"/v5.16/api-reference/phone-connections/get-phone-connections"},{"title":"Create phone connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /phoneConnections","href":"/v5.16/api-reference/phone-connections/create-phone-connection"},{"title":"Get phone connection by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /phoneConnections/{id}","href":"/v5.16/api-reference/phone-connections/get-phone-connection-by-id"},{"title":"Delete phone connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /phoneConnections/{id}","href":"/v5.16/api-reference/phone-connections/delete-phone-connection"},{"title":"Update phone connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /phoneConnections/{id}","href":"/v5.16/api-reference/phone-connections/update-phone-connection"},{"title":"Delete multiple phone connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /phoneConnections/batch","href":"/v5.16/api-reference/phone-connections/delete-multiple-phone-connections"}]},{"group":"web-rtc-connections","pages":[{"title":"Get WebRTC connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /webRtcConnections","href":"/v5.16/api-reference/web-rtc-connections/get-webrtc-connections"},{"title":"Create WebRTC connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /webRtcConnections","href":"/v5.16/api-reference/web-rtc-connections/create-webrtc-connection"},{"title":"Get WebRTC connection by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /webRtcConnections/{id}","href":"/v5.16/api-reference/web-rtc-connections/get-webrtc-connection-by-id"},{"title":"Delete WebRTC connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /webRtcConnections/{id}","href":"/v5.16/api-reference/web-rtc-connections/delete-webrtc-connection"},{"title":"Update WebRTC connection","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json patch /webRtcConnections/{id}","href":"/v5.16/api-reference/web-rtc-connections/update-webrtc-connection"},{"title":"Delete multiple WebRTC connections","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /webRtcConnections/batch","href":"/v5.16/api-reference/web-rtc-connections/delete-multiple-webrtc-connections"}]},{"group":"evaluations","pages":[{"title":"Get evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluations","href":"/v5.16/api-reference/evaluations/get-evaluations"},{"title":"Get evaluation count and last-evaluated date per product","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluations/summary","href":"/v5.16/api-reference/evaluations/get-evaluation-count-and-last-evaluated-date-per-product"},{"title":"Get evaluation by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluations/{id}","href":"/v5.16/api-reference/evaluations/get-evaluation-by-id"},{"title":"Delete evaluation","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /evaluations/{id}","href":"/v5.16/api-reference/evaluations/delete-evaluation"},{"title":"Create evaluations from session","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromSession","href":"/v5.16/api-reference/evaluations/create-evaluations-from-session"},{"title":"Evaluate multiple sessions in one call","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromSessions","href":"/v5.16/api-reference/evaluations/evaluate-multiple-sessions-in-one-call"},{"title":"Create evaluations for a single trace","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromInferenceResult","href":"/v5.16/api-reference/evaluations/create-evaluations-for-a-single-trace"},{"title":"Create single-turn evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/singleTurn","href":"/v5.16/api-reference/evaluations/create-single-turn-evaluations"},{"title":"Retry failed evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/retry","href":"/v5.16/api-reference/evaluations/retry-failed-evaluations"},{"title":"Evaluate a version","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromVersion","href":"/v5.16/api-reference/evaluations/evaluate-a-version"},{"title":"Replay evaluations onto a new metric revision","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromMetrics","href":"/v5.16/api-reference/evaluations/replay-evaluations-onto-a-new-metric-revision"},{"title":"Replay evaluations onto a new test case revision","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/fromTestCases","href":"/v5.16/api-reference/evaluations/replay-evaluations-onto-a-new-test-case-revision"},{"title":"Delete multiple evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /evaluations/batch","href":"/v5.16/api-reference/evaluations/delete-multiple-evaluations"},{"title":"Get pending human evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluations/human/pending","href":"/v5.16/api-reference/evaluations/get-pending-human-evaluations"},{"title":"Get completed human evaluations","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluations/human/completed","href":"/v5.16/api-reference/evaluations/get-completed-human-evaluations"},{"title":"Claim an evaluation for human review or annotation","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/{id}/claim","href":"/v5.16/api-reference/evaluations/claim-an-evaluation-for-human-review-or-annotation"},{"title":"Release a claimed evaluation or annotation","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/{id}/release","href":"/v5.16/api-reference/evaluations/release-a-claimed-evaluation-or-annotation"},{"title":"Submit a human evaluation or annotation score","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/{id}/submit","href":"/v5.16/api-reference/evaluations/submit-a-human-evaluation-or-annotation-score"},{"title":"Edit a submitted human evaluation","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluations/{id}/edit-human","href":"/v5.16/api-reference/evaluations/edit-a-submitted-human-evaluation"},{"title":"Remove a human annotation","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /evaluations/{id}/human-annotation","href":"/v5.16/api-reference/evaluations/remove-a-human-annotation"}]},{"group":"evaluator-models","pages":[{"title":"Get evaluator models","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /evaluatorModels","href":"/v5.16/api-reference/evaluator-models/get-evaluator-models"},{"title":"Check judge generation settings against the model","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /evaluatorModels/test-generation-settings","href":"/v5.16/api-reference/evaluator-models/check-judge-generation-settings-against-the-model"}]},{"group":"comments","pages":[{"title":"Create comment","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /comments","href":"/v5.16/api-reference/comments/create-comment"},{"title":"List distinct comment labels","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /comments/tags","href":"/v5.16/api-reference/comments/list-distinct-comment-labels"},{"title":"Delete comment","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /comments/{commentId}","href":"/v5.16/api-reference/comments/delete-comment"}]},{"group":"runs","pages":[{"title":"Get runs","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /runs","href":"/v5.16/api-reference/runs/get-runs"},{"title":"Create run","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /runs","href":"/v5.16/api-reference/runs/create-run"},{"title":"Close run","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /runs/{id}/close","href":"/v5.16/api-reference/runs/close-run"},{"title":"Run a run again","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /runs/{id}/relaunch","href":"/v5.16/api-reference/runs/run-a-run-again"},{"title":"Cancel run","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json post /runs/{id}/cancel","href":"/v5.16/api-reference/runs/cancel-run"},{"title":"Get run metric summary","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /runs/{id}/metric-summary","href":"/v5.16/api-reference/runs/get-run-metric-summary"},{"title":"Get run by ID","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json get /runs/{id}","href":"/v5.16/api-reference/runs/get-run-by-id"},{"title":"Delete run","deprecated":null,"version":null,"openapi":"/v5.16/openapi.json delete /runs/{id}","href":"/v5.16/api-reference/runs/delete-run"}]}]}]}]},{"version":"5.15","pages":[{"title":"5.15","href":"/v5.15/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.14","pages":[{"title":"5.14","href":"/v5.14/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.13","pages":[{"title":"5.13","href":"/v5.13/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.12","pages":[{"title":"5.12","href":"/v5.12/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.11","pages":[{"title":"5.11","href":"/v5.11/api-reference/versions/get-or-create-version-by-facts"}]},{"version":"5.10","pages":[{"title":"5.10","href":"/v5.10/api-reference/versions/get-or-create-version-by-facts"}]}]},"basePath":"","title":"Get or create version by facts - Galtea Docs","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}