Update version

Update an existing version. See Versions.

PATCH /versions/{id}

Update version

cURL

curl --request PATCH \
  --url https://api.galtea.ai/versions/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "ver_123",
  "productId": "prod_123",
  "userId": "user_123",
  "name": "1.0.0",
  "description": "Version description",
  "modelId": "model_123",
  "systemPrompt": "You are a helpful assistant",
  "datasetUri": "https://example.com/dataset.csv",
  "datasetDescription": "Training dataset",
  "guardrails": "Safety guidelines",
  "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"
}
'

200

{
  "id": "ver_123",
  "productId": "prod_123",
  "userId": "user_123",
  "name": "1.0.0",
  "description": "Version description",
  "modelId": "model_123",
  "systemPrompt": "You are a helpful assistant",
  "datasetUri": "https://example.com/dataset.csv",
  "datasetDescription": "Training dataset",
  "guardrails": "Safety guidelines",
  "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"
}

Authorizations

Authorization · string · header · required

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-....

Path Parameters

id · string · required

Version ID

Body

application/json

id · string

Example:

"ver_123"

productId · string

Example:

"prod_123"

userId · string | null

Example:

"user_123"

name · string

Example:

"1.0.0"

description · string | null

Example:

"Version description"

modelId · string | null

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"

otelOutputSourceRule · object | null

Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per product or version (version wins). Applied only when no LLM output is present.

Show child attributes

Example:

{
  "spanName": "ExecuteActivity:save_reply",
  "attribute": "app.arguments",
  "path": "$[0].message.content",
  "predicate": {
    "path": "$[0].message.role",
    "equals": "assistant"
  }
}

initializationEndpointConnectionId · string | null

Example:

"ec_123"

conversationEndpointConnectionId · string | null

Example:

"ec_123"

finalizationEndpointConnectionId · string | null

Example:

"ec_123"

phoneConnectionId · string | null

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

Response

200

application/json

Version updated successfully

id · string

Example:

"ver_123"

productId · string

Example:

"prod_123"

userId · string | null

Example:

"user_123"

name · string

Example:

"1.0.0"

description · string | null

Example:

"Version description"

modelId · string | null

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"

otelOutputSourceRule · object | null

Recover a turn's user-visible output for templated or non-LLM replies whose final answer lives on a non-LLM span. Set per product or version (version wins). Applied only when no LLM output is present.

Show child attributes

Example:

{
  "spanName": "ExecuteActivity:save_reply",
  "attribute": "app.arguments",
  "path": "$[0].message.content",
  "predicate": {
    "path": "$[0].message.role",
    "equals": "assistant"
  }
}

initializationEndpointConnectionId · string | null

Example:

"ec_123"

conversationEndpointConnectionId · string | null

Example:

"ec_123"

finalizationEndpointConnectionId · string | null

Example:

"ec_123"

phoneConnectionId · string | null

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