Skip to main content
PUT
/
agents
/
{agentId}
/
versioned_prompts
/
{id}
Update versioned prompt
curl --request PUT \
  --url https://api.vogent.ai/api/agents/{agentId}/versioned_prompts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "aiModelId": "<string>",
  "agentType": "STANDARD",
  "prompt": "<string>",
  "flowDefinition": {
    "nodes": [
      {
        "id": "<string>",
        "name": "<string>",
        "type": "<string>",
        "transitionRules": [
          {
            "conditionType": "always",
            "arrayConditionType": "any",
            "field": "<string>",
            "value": "<string>",
            "values": [
              "<string>"
            ],
            "transitionNodeId": "<string>"
          }
        ],
        "nodeData": {}
      }
    ],
    "globalContext": "<string>",
    "aiOpen": true,
    "openingLineType": "INBOUND_ONLY"
  },
  "name": "<string>",
  "modelOptionValues": [
    {
      "optionId": "<string>",
      "value": "<string>"
    }
  ]
}'
{
  "id": "<string>",
  "name": "<string>",
  "agentType": "STANDARD",
  "prompt": "<string>",
  "flowDefinition": {
    "nodes": [
      {
        "id": "<string>",
        "name": "<string>",
        "type": "<string>",
        "transitionRules": [
          {
            "conditionType": "always",
            "arrayConditionType": "any",
            "field": "<string>",
            "value": "<string>",
            "values": [
              "<string>"
            ],
            "transitionNodeId": "<string>"
          }
        ],
        "outputSchema": "<string>",
        "nodeData": {}
      }
    ],
    "globalContext": "<string>",
    "aiOpen": true,
    "openingLineType": "INBOUND_ONLY"
  },
  "aiModelId": "<string>",
  "modelOptionValues": [
    {
      "optionId": "<string>",
      "value": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

In the form Bearer <api_key_here>. You can find your api key in your dashboard.

Path Parameters

​
agentId
string
required

ID of the agent.

​
id
string
required

ID of the versioned prompt.

Body

application/json

Updates a versioned prompt

​
aiModelId
string

The ID of the model to use.

​
agentType
enum<string>

The type of agent that this prompt represents.

Available options:
STANDARD,
CUSTOM_FLOW
​
prompt
string
​
flowDefinition
object

For agents with agentType CUSTOM_FLOW, the flow definition that you want to use.

​
name
string
​
modelOptionValues
object[]

Response

Successful operation

​
id
string
required

Unique identifier for the versioned prompt

​
name
string
required

Human-readable name for the versioned prompt

​
agentType
enum<string>
required

The type of agent this prompt is designed for (STANDARD or CUSTOM_FLOW)

Available options:
STANDARD,
CUSTOM_FLOW
​
prompt
string | null
required

The actual prompt content that will be used by the agent. Can be null for CUSTOM_FLOW agent types

​
flowDefinition
object

The flow definition for the agent. Only defined for CUSTOM_FLOW agent types.

​
aiModelId
string

The AI model ID to use for the agent.

​
modelOptionValues
object[]
⌘I