Developer Documentation

Welcome to the Toolzbytes Pro API ecosystem. Our developer platform is built on an enterprise-scale distributed processing network, allowing you to manipulate, convert, and compress files up to **2.5GB asynchronously**.

This reference contains detail models, expected data structures, REST resources, and chunk-streaming guidelines. By routing programmatic requests through our network, you avoid local processing performance spikes.

Quick SDK Status

Our public endpoints serve standard JSON structures. All requests require SSL and must be targeted directly at the production region node listed below.

Production Regional Host

https://api.Toolzbytes.com/v1 HTTPS

Authentication

The Toolzbytes API utilizes standard bearer keys for authentication purposes. Your production secrets carry full administrative privileges. Keep them guarded and do not share them within client-side code repositories.

Authorization Header format

All network operations against secure resources must include the following request header parameter:

Authorization: Bearer pm_live_51NxhFGCuR91024...

Simulating Invalid Authorization

If your credentials fail authentication checks or lack the necessary active plan limits (for example, attempting files over 5MB on free parameters), the network responds with a standard payload code:

{ "status": "error", "code": 401, "message": "Activation required. Your file size parameters exceeded free allocation limits." }

Upload File Parameter

Before applying format operations (like converting or compressing), you must stream the document parameter into our secure binary upload channel. We split large elements into chunks.

POST /files/upload

Form Parameters

Key	Type	Required	Description
file	binary	Yes	The physical document file (Max size 500MB+ for Pro, 5MB for trial).
sandbox	boolean	No	Set to true to isolate validation tasks without billing parameters.

Request Example

curl -X POST https://api.Toolzbytes.com/v1/files/upload \
  -H "Authorization: Bearer pm_live_51NxhFGCuR91" \
  -F "file=@/path/to/technical_manual_540MB.pdf"

const fs = require('fs');
const axios = require('axios');
const FormData = require('form-data');

const form = new FormData();
form.append('file', fs.createReadStream('/path/to/technical_manual_540MB.pdf'));

axios.post('https://api.Toolzbytes.com/v1/files/upload', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer pm_live_51NxhFGCuR91'
  }
}).then(res => console.log(res.data));

import requests

headers = { 'Authorization': 'Bearer pm_live_51NxhFGCuR91' }
files = { 'file': open('/path/to/technical_manual_540MB.pdf', 'rb') }

response = requests.post(
    'https://api.Toolzbytes.com/v1/files/upload', 
    headers=headers, 
    files=files
)
print(response.json())

Convert Formats

Convert structured PDF indices into target editable parameters seamlessly across Microsoft and vector image directories.

POST /files/convert

Request Body Parameters

{ "file_id": "file_pm_891048aBcX", "target_format": "docx", "ocr_enabled": true, "language_priority": ["en", "es"] }

Success Response (200 OK)

{ "status": "success", "task_id": "task_cnv_91048bcZ", "original_file": "file_pm_891048aBcX", "download_url": "https://api.Toolzbytes.com/v1/files/download/output_revised.docx", "pages_processed": 542, "processing_duration_sec": 4.8 }

Compress File

Utilize our smart metadata pruning matrix to minimize document size structures instantly. Perfect for processing files over 500MB.

POST /files/compress

Compression Level Metrics

Level Parameter	DPI Definition	Target Application
extreme	72 DPI	Compressed specifically for mobile screen distribution.
medium	150 DPI	Perfect balance for general email and desktop sharing.
low	300 DPI	Retains maximum quality for professional design print files.