Skip to main content
curl --request GET \
  --url https://app.voker.ai/api/v1/agents/customer-support-agent/agent-versions/v1 \
  --header "Authorization: Bearer $VOKER_API_KEY"
Pass your API key as a Bearer token in the Authorization header: Authorization: Bearer YOUR_API_KEYSet the VOKER_API_KEY environment variable in your application to keep your key out of source code.

​
Get Agent Version

GET /api/v1/agents/{agent_name}/agent-versions/{agent_version_name} Path parameters
​
agent_name
string
required
The name of the parent agent.
​
agent_version_name
string
required
The name of the agent version.
Responses
​
agent_version_name
string
The unique name of the agent version within its agent.
​
description
string
Optional description of the version. May be null.
​
agent_version_number
integer
Unique number assigned to the agent version within its agent.
​
created_at
string
ISO 8601 timestamp of when the version was created.
​
deprecated_at
string
ISO 8601 timestamp of when the version was deprecated, or null if active.
Returns one of the following error types:
{ "type": "agent-not-found" }

{ "type": "agent-version-not-found" }

​
Create Agent Version

PUT /api/v1/agents/{agent_name}/agent-versions Path parameters
​
agent_name
string
required
The name of the parent agent. The agent must already exist.
Request body
​
agent_version_name
string
required
A unique identifier for this version within the agent (e.g., "v1.2.0" or "production").
​
description
string
An optional human-readable description of what changed in this version.
Responses
​
agent_version_name
string
The unique name of the created agent version.
​
description
string
Description of the version. May be null.
​
agent_version_number
integer
Auto-assigned numeric identifier.
​
created_at
string
ISO 8601 timestamp of when the version was created.
​
deprecated_at
string
Always null for newly created versions.
{ "type": "agent-not-found" }