List versioned prompts

Path Parameters

agentId

string

required

ID of the agent.

Query Parameters

limit

integer

default:

100

The maximum number of prompts to list.

cursor

string

The pagination cursor returned by the previous request. Feed the result provided by vogent verbatim.

Response

200 - application/json

cursor

string | null

required

A cursor you can pass to fetch the next page. If no next page exists, the cursor will be null.

data

object[]

required

data.agentType

enum<string>

required

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

Available options:

STANDARD,

CUSTOM_FLOW

data.id

string

required

Unique identifier for the versioned prompt

data.name

string

required

Human-readable name for the versioned prompt

data.prompt

string | null

required

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

data.flowDefinition

object

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

data.flowDefinition.nodes

object[]

required

data.flowDefinition.nodes.id

string

required

data.flowDefinition.nodes.name

string

required

data.flowDefinition.nodes.nodeData

object

required

The node-specific configuration. View the schemas by type at https://docs.vogent.ai/flow.

data.flowDefinition.nodes.transitionRules

object[]

required

data.flowDefinition.nodes.transitionRules.conditionType

enum<string>

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.

Available options:

always,

equal,

in,

greater,

less,

language

data.flowDefinition.nodes.transitionRules.transitionNodeId

string

required

data.flowDefinition.nodes.transitionRules.field

string | null

data.flowDefinition.nodes.transitionRules.value

string | null

data.flowDefinition.nodes.transitionRules.values

string[] | null

data.flowDefinition.nodes.type

string

required

The node type. View the available types at https://docs.vogent.ai/flow.

data.flowDefinition.nodes.outputSchema

string | null

The JSON schema describing the output of this node. This is generated automatically from the node type and node data.

API Documentation

Dials

Agents

Versioned Prompts

Phone Numbers

List versioned prompts

Path Parameters

Query Parameters

Response