Convert Document

curl --request POST \
  --url https://api.dreep.cloud/api/v1/convert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file \
  --form page=2 \
  --form folder=contracts/pdf \
  --form folderId=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --form 'key=<string>' \
  --form autoCreateFolders=true

import requests

url = "https://api.dreep.cloud/api/v1/convert"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "page": "2",
    "folder": "contracts/pdf",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "key": "<string>",
    "autoCreateFolders": "true"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('page', '2');
form.append('folder', 'contracts/pdf');
form.append('folderId', '3c90c3cc-0d44-4b50-8888-8dd25736052a');
form.append('key', '<string>');
form.append('autoCreateFolders', 'true');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.dreep.cloud/api/v1/convert', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dreep.cloud/api/v1/convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dreep.cloud/api/v1/convert"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dreep.cloud/api/v1/convert")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dreep.cloud/api/v1/convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filename": "contract.pdf",
    "format": "pdf",
    "mimetype": "application/pdf",
    "sizeBytes": 123,
    "status": "ready",
    "url": "<string>"
  }
}

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filename": "contract.pdf",
    "format": "pdf",
    "mimetype": "application/pdf",
    "sizeBytes": 123,
    "status": "ready",
    "url": "<string>"
  }
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

Documents

Convert Document

Upload a document and convert it to another format - Word to PDF, PDF to Word, a spreadsheet to CSV, a PDF page to an image. The result is saved to your Dreep storage as a new asset, in the folder you name or the project’s default folder.

The request waits for the conversion, up to two minutes. Most documents take a second or two and return 201 with the ready asset. A very long one returns 202: the asset is created and its url answers 202 until the conversion finishes.

Each conversion counts toward your plan’s monthly document conversions. If the same document was already converted the same way through its fetch URL, that result is reused for free.

POST

api

convert

Convert Document

curl --request POST \
  --url https://api.dreep.cloud/api/v1/convert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file \
  --form page=2 \
  --form folder=contracts/pdf \
  --form folderId=3c90c3cc-0d44-4b50-8888-8dd25736052a \
  --form 'key=<string>' \
  --form autoCreateFolders=true

import requests

url = "https://api.dreep.cloud/api/v1/convert"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "page": "2",
    "folder": "contracts/pdf",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "key": "<string>",
    "autoCreateFolders": "true"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('file', '<string>');
form.append('page', '2');
form.append('folder', 'contracts/pdf');
form.append('folderId', '3c90c3cc-0d44-4b50-8888-8dd25736052a');
form.append('key', '<string>');
form.append('autoCreateFolders', 'true');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.dreep.cloud/api/v1/convert', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dreep.cloud/api/v1/convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dreep.cloud/api/v1/convert"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dreep.cloud/api/v1/convert")
  .header("Authorization", "Bearer <token>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dreep.cloud/api/v1/convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"page\"\r\n\r\n2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folder\"\r\n\r\ncontracts/pdf\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"folderId\"\r\n\r\n3c90c3cc-0d44-4b50-8888-8dd25736052a\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"autoCreateFolders\"\r\n\r\ntrue\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filename": "contract.pdf",
    "format": "pdf",
    "mimetype": "application/pdf",
    "sizeBytes": 123,
    "status": "ready",
    "url": "<string>"
  }
}

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "folderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "filename": "contract.pdf",
    "format": "pdf",
    "mimetype": "application/pdf",
    "sizeBytes": 123,
    "status": "ready",
    "url": "<string>"
  }
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

{
  "error": true,
  "message": "Invalid request parameters",
  "code": "invalid_request"
}

Upload a document and get it back in another format, saved as a new asset. Use it when the file isn’t in Dreep yet, or when you want the converted file stored on its own. For documents you’ve already uploaded, you can also convert them by URL.

Word to PDF

curl -X POST "https://api.dreep.cloud/api/v1/convert" \
  -H "Authorization: Bearer drp_live_xxxxx" \
  -F "[email protected]" \
  -F "format=pdf"

{
  "asset": {
    "id": "5c1d8a72-3f0e-4b8d-9a61-2e7b4c9d0f13",
    "folderId": "a41f0c2e-6b7d-4e8a-9f3c-1d2e5b6a7c8d",
    "filename": "contract.pdf",
    "format": "pdf",
    "mimetype": "application/pdf",
    "sizeBytes": 104719,
    "status": "ready",
    "url": "https://api.dreep.cloud/api/v1/fetch/5c1d8a72-3f0e-4b8d-9a61-2e7b4c9d0f13.pdf"
  }
}

Saving to a folder

With no folder given, the result is saved to the project’s default folder. Name one with folder (a path, created on demand), folderId (a UUID) or key (a full path that also names the file):

curl -X POST "https://api.dreep.cloud/api/v1/convert" \
  -H "Authorization: Bearer drp_live_xxxxx" \
  -F "[email protected]" \
  -F "format=pdf" \
  -F "folder=reports/2026"

See Folders & Paths.

What converts to what

Upload	`format`
Word: `doc`, `docx`, `odt`, `rtf`	`pdf`, `docx`, `odt`, `rtf`
Excel: `xls`, `xlsx`, `ods`, `csv`	`pdf`, `xlsx`, `ods`, `csv`
PowerPoint: `ppt`, `pptx`, `odp`	`pdf`, `pptx`, `odp`
PDF	`docx`, `png`, `jpeg`

Anything else returns 400 with the formats that file can convert to. Converting a spreadsheet to csv exports its first sheet. To render one page of a PDF as an image, pass page:

curl -X POST "https://api.dreep.cloud/api/v1/convert" \
  -H "Authorization: Bearer drp_live_xxxxx" \
  -F "[email protected]" \
  -F "format=png" \
  -F "page=2"

Long conversions

The request waits for the result, up to two minutes. Most documents take a second or two and return 201. A very long document returns 202 with status: "processing". The asset already exists, and its url answers 202 until the conversion finishes, then serves the file. Poll the URL, as with video transformations.

Billing and limits

Each conversion counts toward your plan’s monthly document conversions: Free 100, Starter 2,000, Pro 10,000. Once those are used, conversions come from a +1,000 add-on pack ($4.99). If the same document was already converted the same way through its fetch URL, that result is reused for free.

	Free	Starter and Pro
Largest document	10 MB	100 MB
PDF output	First 5 pages	All pages
PDF to Word	Not included	Included
PDF page images	Pages 1 to 5	Any page

Going over a limit returns 402 with code: "LIMIT_EXCEEDED" and featureKey: "document_conversions_monthly". The saved result also counts toward your storage, so a full storage quota returns 402 too. A conversion only counts once the result is stored, so a failed request costs nothing.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

file

required

The document to convert. Word (doc, docx, odt, rtf), Excel (xls, xlsx, ods, csv), PowerPoint (ppt, pptx, odp) or PDF.

format

enum<string>

required

The format to convert to. Documents convert within their own family (a spreadsheet can't become a Word document); PDFs convert to docx, png or jpeg.

Available options:

pdf,

docx,

odt,

rtf,

xlsx,

ods,

csv,

pptx,

odp,

png,

jpeg

page

integer

Only when converting a PDF to png or jpeg: which page to render as the image (page 1 if omitted). Leave it out for every other format - those always include all pages.

Required range: x >= 1

folder

string

Slug path of the folder to save the result into, relative to the project root. Missing folders are created.

Example:

"contracts/pdf"

folderId

string<uuid>

UUID of an existing folder to save the result into. Mutually exclusive with folder.

key

string

Full storage path for the result, e.g. contracts/pdf/acme. The folder part is created like folder; the last segment names the file.

autoCreateFolders

enum<string>

default:true

Set to false to require that folder already exists.

Available options:

true,

false

Response

Document converted and saved

asset

object

The saved result.

Show child attributes

Upload

OCR

Background Removal

Documents

Media

Folders

Presets

Usage & Billing

Convert Document

Word to PDF

Saving to a folder

What converts to what

Long conversions

Billing and limits

Authorizations

Body

Response

​Word to PDF

​Saving to a folder

​What converts to what

​Long conversions

​Billing and limits

Authorizations

Body

Response

Word to PDF

Saving to a folder

What converts to what

Long conversions

Billing and limits