Get Agent Version

Retrieves a specific version of an agent definition.

GET https://api.futureagi.com/simulate/agent-definitions/{agent_id}/versions/{version_id}/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Path parameters

agent_id UUID Required

The agent definition ID.

version_id UUID Required

The agent version ID.

Response

200 OK
id string
UUID of the agent version.
version_number integer
Sequential version number, starting from 1.
version_name string
Short version name (e.g., v1, v2).
version_name_display string
Formatted display name for the version.
status string
Lifecycle status: draft, active, archived, or deprecated.
status_display string
Human-readable status label.
score number
Evaluation score from 0.0 to 10.0. null if no tests run.
test_count integer
Total test executions run against this version.
pass_rate number
Test pass percentage from 0 to 100. null if no tests run.
description string
Version description.
commit_message string
Commit message for this version.
release_notes string
Release notes. null if not provided.
agent_definition string
UUID of the parent agent definition.
organization string
UUID of the owning organization.
configuration_snapshot object
Immutable snapshot of the agent configuration at version creation time.
agent_name string
Agent display name at snapshot time.
agent_type string
voice or text.
inbound boolean
Whether the agent handled inbound calls.
languages array
Supported language codes.
language string
Primary ISO 639-1 language code.
provider string
Voice provider.
contact_number string
Phone number at snapshot time.
assistant_id string
External assistant ID.
api_key string
Provider API key.
authentication_method string
Authentication method for provider.
observability_enabled boolean
Whether observability was enabled.
description string
Agent description at snapshot time.
knowledge_base string
UUID of linked knowledge base.
commit_message string
Commit message.
model string
AI model identifier.
model_details object
Extended model configuration.
is_active boolean
Whether this is the currently active version.
is_latest boolean
Whether this is the most recently created version.
created_at datetime
ISO 8601 creation timestamp.
updated_at datetime
ISO 8601 last-modified timestamp.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Agent definition or version not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE