---
title: "Export recordings"
method: POST
path: "/api/v1/conversations:export"
tags: ["Conversations"]
---

# Export recordings

`POST /api/v1/conversations:export`

Schedule a task to have conversations matching the specified criteria emailed to you. Exports include downloadable links to audio/video of recordings plus metadata.

## Request body

- object
  - `add_usage` boolean, nullable — Whether to include usage information in export
  - `callback_url` string, nullable — URL to which to post the completed link
  - `email_on_complete` boolean, nullable — Whether to email when export is complete
  - `end` integer, nullable — End timestamp for export range (epoch milliseconds)
  - `start` integer, nullable — Start timestamp for export range (epoch milliseconds)

## Response `202`

Success

---

[API](https://skmtc.net/chorus/apis/chorus-api.md) · [All operations](https://skmtc.net/chorus/apis/chorus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chorus/chorus-api/revisions/f00047222b8f/schema)
