---
title: "Export Workspace To Path Endpoint"
method: POST
path: "/api/workspaces/{workspace_id}/export-to-path"
tags: ["runtime_mutations", "workspace"]
---

# Export Workspace To Path Endpoint

`POST /api/workspaces/{workspace_id}/export-to-path`

Write a workspace's ``.qualia`` archive into a local directory.

The download endpoint hands the archive to the browser, which cannot
survive a multi-gigabyte workspace export: buffering it crashes the
renderer and takes the app's socket connection with it. Here the
backend writes the file itself, so the bytes never leave this
process. Only available when the workspace is on this machine —
anywhere else the path would name a directory the user cannot see.

## Path parameters

- `workspace_id` string, required

## Request body

- ExportToPathRequest — Save an export into a directory the user picked on this machine.
  - `directory` string, required
  - `include_workspace_files` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

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