---
title: "Update versioned prompt"
method: PUT
path: "/agents/{agentId}/versioned_prompts/{id}"
---

# Update versioned prompt

`PUT /agents/{agentId}/versioned_prompts/{id}`

## Request

- Base URL: `https://api.vogent.ai/api`
- URL: `https://api.vogent.ai/api/agents/{agentId}/versioned_prompts/{id}`
- Auth: HTTP bearer

Updates a versioned prompt for a given agent.

## Request body

- UpdateVersionedPromptInput
  - `aiModelId` string: The ID of the model to use.
  - `agentType` 'STANDARD' | 'CUSTOM_FLOW'
  - `prompt` string
  - `flowDefinition` FlowDefinitionInput
    - `nodes` ApiFlowNodeInput[]
      - `id` string, required
      - `name` string, required: One of the allowed flow node types. View the available types at https://docs.vogent.ai/flow.
      - `type` string, required
      - `transitionRules` FlowTransitionRuleInput[], required
        - `conditionType` 'always' | 'equal' | 'in' | 'greater' | 'less' | 'language', required: The condition used to evaluate the transition rule. If language, the value will be used as a natural language condition to describe when to execute a transition.
        - `arrayConditionType` 'any' | 'all', nullable: The type of array condition to apply. 'any' means at least one element must match, 'all' means all elements must match.
        - `field` string, nullable
        - `value` string, nullable
        - `values` string[], nullable
        - `transitionNodeId` string, required
      - `nodeData` object, required: The node-specific configuration. View the configurations by node type at https://docs.vogent.ai/flow.
    - `globalContext` string, nullable
    - `aiOpen` boolean: Deprecated, use openingLineType instead.
    - `openingLineType` 'INBOUND_ONLY' | 'INBOUND_OUTBOUND' | 'NONE'
  - `name` string
  - `modelOptionValues` ModelOptionValue[]
    - `optionId` string, required: The ID of option.
    - `value` string, required

## Response `200`

Successful operation

- VersionedPrompt
  - `id` string, required: Unique identifier for the versioned prompt
  - `name` string, required: Human-readable name for the versioned prompt
  - `agentType` 'STANDARD' | 'CUSTOM_FLOW', required
  - `prompt` string, nullable, required: The actual prompt content that will be used by the agent. Can be null for CUSTOM_FLOW agent types
  - `flowDefinition` FlowDefinition
    - `nodes` ApiFlowNode[], required
      - `id` string, required
      - `name` string, required
      - `type` string, required: The node type. View the available types at https://docs.vogent.ai/flow.
      - `transitionRules` FlowTransitionRule[], required
        - `conditionType` 'always' | 'equal' | 'in' | 'greater' | 'less' | 'language', required: The condition used to evaluate the transition rule. If language, the value will be used as a natural language condition to describe when to execute a transition.
        - `arrayConditionType` 'any' | 'all', nullable: The type of array condition to apply. 'any' means at least one element must match, 'all' means all elements must match.
        - `field` string, nullable
        - `value` string, nullable
        - `values` string[], nullable
        - `transitionNodeId` string, required
      - `outputSchema` string, nullable: The JSON schema describing the output of this node. This is generated automatically from the node type and node data.
      - `nodeData` object, required: The node-specific configuration. View the schemas by type at https://docs.vogent.ai/flow.
    - `globalContext` string, nullable, required
    - `aiOpen` boolean, required: Deprecated, use openingLineType instead.
    - `openingLineType` 'INBOUND_ONLY' | 'INBOUND_OUTBOUND' | 'NONE', required
  - `aiModelId` string: The AI model ID to use for the agent.
  - `modelOptionValues` ModelOptionValue[]
    - `optionId` string, required: The ID of option.
    - `value` string, required

## Other responses

- `400`: Invalid input
- `422`: Validation exception

---

[API](https://skmtc.dev/vogent/apis/vogent-openapi-3-0.md) - [All operations](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/vogent/apis/vogent-openapi-3-0/revisions/a5966cc364ef?raw)