List Agent Versions

Retrieve a paginated list of all versions for a given agent definition. Supports limit and page parameters. Returns version metadata and commit history.

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

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.

Query parameters

limit integer Optional

Results per page. Defaults to 10.

page integer Optional

Page number. Defaults to 1.

Response

200 OK
count integer
Total versions for this agent definition.
next string
URL of the next page, or null.
previous string
URL of the previous page, or null.
results array

Array of agent version objects.

id string
UUID of the 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.
status string
Lifecycle status: draft, active, archived, or deprecated.
status_display string
Human-readable status label.
score number
Evaluation score (0.0–10.0). null if untested.
test_count integer
Total test executions run.
pass_rate number
Test pass percentage (0–100). null if untested.
description string
Version description.
commit_message string
Commit message for this version.
is_active boolean
Whether this is the currently active version.
is_latest boolean
Whether this is the most recent version.
created_at datetime
ISO 8601 creation timestamp.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Agent definition not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE