> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agent Flow Versions

> List historical versions of an agent's flow configuration

# List Agent Flow Versions

List historical versions of an agent's flow configuration. Each save produces a version entry that can be inspected.

## Endpoint

```
GET /api/v1/agents/{agent_id}/flow/versions
```

## Path parameters

<ParamField path="agent_id" type="string" required>Agent UUID.</ParamField>

## Request headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer talq_your_environment_token_here`
</ParamField>

## Examples

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/versions" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "versions": [
        {
          "id": "version-uuid-3",
          "version": "1.2.0",
          "created_at": "2024-01-15T10:00:00Z",
          "is_current": true
        },
        {
          "id": "version-uuid-2",
          "version": "1.1.0",
          "created_at": "2024-01-10T14:00:00Z",
          "is_current": false
        },
        {
          "id": "version-uuid-1",
          "version": "1.0.0",
          "created_at": "2024-01-05T09:00:00Z",
          "is_current": false
        }
      ]
    }
  }
  ```
</ResponseExample>

## Notes

* Versioning is automatic on every flow update.
* Restoring an older version requires fetching its `flow_config` and submitting via [Update Agent Flow](/api-reference/endpoints/update-agent-flow).