---
title: "Export an App and its child entities as a portable bundle (v2)"
method: GET
path: "/v2/apps/{appId}/export"
tags: ["Apps"]
---

# Export an App and its child entities as a portable bundle (v2)

`GET /v2/apps/{appId}/export`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/export`
- Auth: HTTP bearer

Returns a versioned bundle (`schemaVersion: ethora.app.bundle.v1`)
containing the App doc (secrets stripped) and selected child entities.

Use cases:
- **Backup**: customers can snapshot an app and its assets as JSON.
- **Migration**: move an app between environments by exporting from
  the source and re-importing at the destination.

Authorization: only the app's owner or a super-admin can export.

Format: `json` returns the bundle directly (Content-Type:
application/json with download disposition). `zip` returns a zip
archive containing `bundle.json`.

Default include set is `chats,sources,botInstances` (structural
data without PII). Users are opt-in via `include=users` because
they carry email addresses and other personal data.

## Path parameters

- `appId` string, required

## Query parameters

- `format` 'json' | 'zip'
- `include` string

## Response `200`

bundle

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: app not found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)