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

# Data Exports

> Export call records and AI agent configurations from your workspace as CSV or JSON

Data Exports let you pull operational data out of SquawkVoice for external reporting, BI tooling, compliance archiving, or backup. Exports are available for call records and AI agent configurations.

## Export Types

<Columns cols={2}>
  <Card title="Call Records" icon="phone">
    Export your call history as a CSV file. Includes caller ID, duration, status, disposition, and agent — with optional filters applied.
  </Card>

  <Card title="AI Agent Config" icon="robot">
    Export a complete snapshot of any AI agent's configuration as a JSON file for backup or migration.
  </Card>
</Columns>

***

## Call Records Export

Call record exports are initiated from the Call History page.

1. Open **Studio → Optimize → Call History**.
2. Use the search and filter controls to scope your export — apply date range, agent, status, or disposition filters as needed.
3. Click **Export CSV**.
4. The file downloads immediately.

The exported CSV includes one row per call with the following fields:

| Field           | Description                                       |
| --------------- | ------------------------------------------------- |
| **Caller ID**   | The inbound phone number or identifier            |
| **Date & Time** | Call start timestamp                              |
| **Duration**    | Total call length                                 |
| **Call Status** | Completed, failed, no-answer, busy, etc.          |
| **Agent**       | The AI agent that handled the call                |
| **Call SID**    | Unique call identifier (Twilio SID)               |
| **Disposition** | Outcome set by the agent during or after the call |

<Info>
  The export respects all active filters. If you want a full unfiltered export, clear all filters before clicking Export CSV.
</Info>

***

## AI Agent Configuration Export

You can export a full snapshot of any AI agent as a JSON file. This includes the agent's settings, prompt, variables, action references, and knowledge base configuration.

1. Open the AI agent in **Studio → Build → AI Agents**.
2. Click the **⋮** menu on the agent card (or the options menu inside the agent editor).
3. Select **Export**.
4. The file downloads as `ai-agent-{agentId}.json`.

Use agent exports to:

* **Back up** a working agent configuration before making significant changes
* **Migrate** an agent to a different workspace
* **Share** a configuration with the SquawkVoice support team for troubleshooting

<Warning>
  Agent exports contain your prompt content and configuration details. Treat exported files as sensitive and store them securely.
</Warning>

***

## Tips

* **Filter before exporting** call records to keep file sizes manageable when working with high call volumes.
* **Use Call SID** in call record exports as the stable join key if you need to correlate exported data with telephony records from Twilio.
