API Documentation

Use our REST API to integrate file conversion into your applications. All endpoints are available at the base URL configured via NEXT_PUBLIC_API_URL.

Base URL

https://api.filestool.com

Available Endpoints

GET /api/config

Get runtime configuration including max file size and TTL settings.

POST /api/upload

Upload a file for conversion. Returns a file ID for use in conversion requests.

POST /api/convert

Start a conversion job. Requires file ID and target format.

GET /api/job/:job_id

Poll conversion job status. Returns progress and download token when complete.

GET /api/download/:token

Download the converted file using the token from job completion.

GET /api/tools

List all available conversion tools and supported formats.

Rate Limits

API requests are rate-limited to ensure fair usage. Files are automatically deleted after the configured TTL.