API Documentation
Versioned Prompts
Phone Numbers
Models
List versioned prompts
Lists versioned prompts for a given agent.
curl --request GET \
--url https://api.vogent.ai/api/agents/{agentId}/versioned_prompts
{
"data": [
{
"id": "<string>",
"name": "<string>",
"agentType": "STANDARD",
"prompt": "<string>",
"flowDefinition": {
"nodes": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"transitionRules": [
{
"conditionType": "always",
"field": "<string>",
"value": "<string>",
"values": [
"<string>"
],
"transitionNodeId": "<string>"
}
],
"outputSchema": "<string>",
"nodeData": {}
}
]
},
"modelOptionValues": [
{
"optionId": "<string>",
"value": "<string>"
}
]
}
],
"cursor": "<string>"
}
Path Parameters
ID of the agent.
Query Parameters
The maximum number of prompts to list.
The pagination cursor returned by the previous request. Feed the result provided by vogent verbatim.
Response
Unique identifier for the versioned prompt
Human-readable name for the versioned prompt
The type of agent this prompt is designed for (STANDARD or CUSTOM_FLOW)
STANDARD
, CUSTOM_FLOW
The actual prompt content that will be used by the agent. Can be null for CUSTOM_FLOW agent types
The flow definition for the agent. Only defined for CUSTOM_FLOW agent types.
The node type. View the available types at https://docs.vogent.ai/flow.
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.
always
, equal
, in
, greater
, less
, language
The node-specific configuration. View the schemas by type at https://docs.vogent.ai/flow.
The JSON schema describing the output of this node. This is generated automatically from the node type and node data.
A configuration value for the model. You can get a list of available models and their configuration values from /models. All configuration values, with defaults will be returned when you retrieve a versioned prompt.
A cursor you can pass to fetch the next page. If no next page exists, the cursor will be null.
curl --request GET \
--url https://api.vogent.ai/api/agents/{agentId}/versioned_prompts
{
"data": [
{
"id": "<string>",
"name": "<string>",
"agentType": "STANDARD",
"prompt": "<string>",
"flowDefinition": {
"nodes": [
{
"id": "<string>",
"name": "<string>",
"type": "<string>",
"transitionRules": [
{
"conditionType": "always",
"field": "<string>",
"value": "<string>",
"values": [
"<string>"
],
"transitionNodeId": "<string>"
}
],
"outputSchema": "<string>",
"nodeData": {}
}
]
},
"modelOptionValues": [
{
"optionId": "<string>",
"value": "<string>"
}
]
}
],
"cursor": "<string>"
}