---
title: "Create a derived workspace file"
method: POST
path: "/tally/files/transform"
tags: ["Tally Files"]
---

# Create a derived workspace file

`POST /tally/files/transform`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/tally/files/transform`
- Auth: HTTP bearer

Packages, extracts, or converts selected visible files into an explicit firm/company destination without changing the sources.

## Request body

- union
  - object
    - `operation` 'package_zip', required
    - `fileIds` string[], required
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationPath` string, required
  - object
    - `operation` 'extract_zip', required
    - `fileId` string, uuid, required
    - `entryPaths` string[]
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationFolderPath` string, required
  - object
    - `operation` 'xlsx_sheet_to_csv', required
    - `fileId` string, uuid, required
    - `sheet` string, required
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationPath` string, required
  - object
    - `operation` 'combine_csv', required
    - `fileIds` string[], required
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationPath` string, required
  - object
    - `operation` 'extract_pdf_pages', required
    - `fileId` string, uuid, required
    - `pages` integer[], required
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationPath` string, required
  - object
    - `operation` 'text_to_pdf', required
    - `fileId` string, uuid, required
    - `companyOrganizationId` string, uuid, nullable, required
    - `destinationPath` string, required

## Response `201`

Derived visible file or files

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)