API // one endpoint shape

Filoven API

Every Filoven tool has a discoverable URL using one shape: POST /api/v1/tools/{slug}. Server-compatible tools run through the API; browser-only tools return 501 without charging credits.

Bearer auth

Generate keys in your dashboard. Free tools skip auth.

Live capability catalog

JSON for text tools, multipart for files, with availability on every entry.

Credit-metered

Pay per call. Refunded on upstream failure.

Quickstart

# List every tool
curl https://fileoven.com/api/v1/tools

# Multipart tool (image OCR)
curl -X POST https://fileoven.com/api/v1/tools/image-ocr \
  -H "Authorization: Bearer sk_live_..." \
  -F "file=@receipt.png"

# JSON tool (color converter, free)
curl -X POST https://fileoven.com/api/v1/tools/color-converter \
  -H "Content-Type: application/json" \
  -d '{"hex":"#3b82f6"}'

# Business automation job (returns HTTP 202)
curl -X POST https://fileoven.com/api/v1/jobs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tool_slug":"color-converter","input":{"hex":"#3b82f6"},"webhook":{"url":"https://client.example/hooks/filoven","secret":"replace-with-16-plus-characters"}}'

# Poll a job
curl https://fileoven.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer sk_live_..."

Async jobs support available JSON-input tools. Webhooks include x-filoven-signature: sha256=..., calculated as HMAC-SHA256 over the raw request body using your supplied secret.

Available tools

Utility

Endpoint	Input	Credits	Status	Description
POST /v1/tools/qr-generator	json	free	available	Generate a QR code (PNG data URL or SVG).
POST /v1/tools/unit-converter	json	free	available	Convert length/weight/volume/temperature.
POST /v1/tools/color-converter	json	free	available	Convert HEX / RGB / HSL.
POST /v1/tools/json-csv	json	free	available	JSON ↔ CSV conversion.
POST /v1/tools/base64	json	free	available	Base64 encode / decode.
POST /v1/tools/timestamp	json	free	available	Unix timestamp ↔ ISO date.
POST /v1/tools/csv-cleaner	json	1	available	Normalize, deduplicate, validate, and safely export CSV data.

Image

Endpoint	Input	Credits	Status	Description
POST /v1/tools/image-converter	multipart	2	available	Convert JPG / PNG / WebP.
POST /v1/tools/image-resize	multipart	2	available	Resize an image.
POST /v1/tools/image-compress	multipart	2	available	Re-encode with quality control.
POST /v1/tools/favicon-generator	multipart	2	available	Build a multi-size favicon.ico.
POST /v1/tools/exif-remove	multipart	1	available	Strip EXIF/GPS metadata.
POST /v1/tools/image-exif	multipart	1	available	Read EXIF/IPTC/XMP metadata.
POST /v1/tools/color-palette	multipart	1	available	Extract dominant colors from an image.

Documents

Endpoint	Input	Credits	Status	Description
POST /v1/tools/image-to-pdf	multipart	3	available	Combine images into a PDF.
POST /v1/tools/pdf-merge	multipart	3	available	Merge multiple PDFs into one.
POST /v1/tools/pdf-split	multipart	3	available	Split a PDF into one file per page (zip).
POST /v1/tools/extract-pdf-pages	multipart	3	available	Extract selected pages into one PDF or a ZIP.
POST /v1/tools/pdf-compress	multipart	2	available	Rebuild PDF with object streams; strip metadata.
POST /v1/tools/pdf-watermark	multipart	3	available	Add a positioned text watermark to selected PDF pages.
POST /v1/tools/pdf-page-numbers	multipart	2	available	Add page numbers to all or selected PDF pages.

Audio

Endpoint	Input	Credits	Status	Description
POST /v1/tools/audio-metadata	multipart	1	available	Read ID3 / Vorbis / MP4 audio tags.
POST /v1/tools/audio-strip	multipart	1	available	Strip ID3v1/ID3v2 tags from MP3.

AI

Endpoint	Input	Credits	Status	Description
POST /v1/tools/image-ocr	multipart	5	available	Extract text from an image (Gemini vision).
POST /v1/tools/speech-transcribe	multipart	15	available	Transcribe audio (gpt-4o-transcribe).

Browser-only or planned (returns 501)

Endpoint	Input	Credits	Status	Description
POST /v1/tools/stl-to-glb	multipart	free	browser-only	Not available server-side: 3D loaders require a browser DOM; use the web tool at /tools/stl-to-glb
POST /v1/tools/glb-to-stl	multipart	free	browser-only	Not available server-side: 3D loaders require a browser DOM; use /tools/glb-to-stl
POST /v1/tools/obj-to-glb	multipart	free	browser-only	Not available server-side: 3D loaders require a browser DOM; use /tools/obj-to-glb
POST /v1/tools/fbx-to-glb	multipart	free	browser-only	Not available server-side: FBX loader requires a browser DOM; use /tools/fbx-to-glb
POST /v1/tools/usdz-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/usdz-converter
POST /v1/tools/model-optimizer	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/model-optimizer
POST /v1/tools/glb-to-obj	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/glb-to-obj
POST /v1/tools/stl-to-obj	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/stl-to-obj
POST /v1/tools/model-viewer	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/model-viewer
POST /v1/tools/ecommerce-image-batch	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ecommerce-image-batch
POST /v1/tools/heic-to-jpg	multipart	free	browser-only	Not available server-side: HEIC decoding requires a browser WASM runtime; use /tools/heic-to-jpg
POST /v1/tools/svg-to-png	multipart	free	browser-only	Not available server-side: SVG rasterization requires a browser canvas; use /tools/svg-to-png
POST /v1/tools/image-crop	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/image-crop
POST /v1/tools/image-watermark	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/image-watermark
POST /v1/tools/image-to-svg	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/image-to-svg
POST /v1/tools/webp-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/webp-converter
POST /v1/tools/meme-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/meme-generator
POST /v1/tools/remove-background	multipart	free	browser-only	Not available server-side: Background removal runs a browser AI model; use /tools/remove-background
POST /v1/tools/upscale-image	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/upscale-image
POST /v1/tools/ai-image-upscaler	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ai-image-upscaler
POST /v1/tools/photo-colorizer	multipart	free	planned	Not available server-side: The web tool is still planned and has no production implementation
POST /v1/tools/pdf-to-md	multipart	free	browser-only	Not available server-side: PDF → Markdown uses browser OCR; use /tools/pdf-to-md
POST /v1/tools/pdf-to-image	multipart	free	browser-only	Not available server-side: PDF rendering requires pdf.js in a browser; use /tools/pdf-to-image
POST /v1/tools/scan-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/scan-to-pdf
POST /v1/tools/word-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/word-to-pdf
POST /v1/tools/word-text	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/word-text
POST /v1/tools/word-html	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/word-html
POST /v1/tools/pdf-to-word	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-word
POST /v1/tools/ocr-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ocr-pdf
POST /v1/tools/document-data-extractor	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/document-data-extractor
POST /v1/tools/pdf-rotate	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-rotate
POST /v1/tools/crop-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/crop-pdf
POST /v1/tools/compare-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/compare-pdf
POST /v1/tools/redact-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/redact-pdf
POST /v1/tools/repair-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/repair-pdf
POST /v1/tools/pdf-to-pdfa	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-pdfa
POST /v1/tools/bates-numbering	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/bates-numbering
POST /v1/tools/flatten-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/flatten-pdf
POST /v1/tools/pdf-forms	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-forms
POST /v1/tools/edit-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/edit-pdf
POST /v1/tools/ai-pdf-assistant	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ai-pdf-assistant
POST /v1/tools/pdf-translator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-translator
POST /v1/tools/sign-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/sign-pdf
POST /v1/tools/excel-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/excel-to-pdf
POST /v1/tools/powerpoint-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/powerpoint-to-pdf
POST /v1/tools/powerpoint-images	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/powerpoint-images
POST /v1/tools/pdf-to-powerpoint	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-powerpoint
POST /v1/tools/pdf-to-excel	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-excel
POST /v1/tools/pdf-password-remove	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-password-remove
POST /v1/tools/protect-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/protect-pdf
POST /v1/tools/html-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/html-to-pdf
POST /v1/tools/markdown-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/markdown-to-pdf
POST /v1/tools/epub-to-pdf	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/epub-to-pdf
POST /v1/tools/pdf-to-epub	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-epub
POST /v1/tools/audio-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/audio-converter
POST /v1/tools/audio-trim	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/audio-trim
POST /v1/tools/audio-merge	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/audio-merge
POST /v1/tools/audio-silence-remove	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/audio-silence-remove
POST /v1/tools/audio-adjuster	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/audio-adjuster
POST /v1/tools/code-reader	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/code-reader
POST /v1/tools/currency-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/currency-converter
POST /v1/tools/password-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/password-generator
POST /v1/tools/uuid-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/uuid-generator
POST /v1/tools/hash-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/hash-generator
POST /v1/tools/word-counter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/word-counter
POST /v1/tools/json-formatter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/json-formatter
POST /v1/tools/case-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/case-converter
POST /v1/tools/url-encoder	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/url-encoder
POST /v1/tools/jwt-decoder	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/jwt-decoder
POST /v1/tools/regex-tester	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/regex-tester
POST /v1/tools/text-diff	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/text-diff
POST /v1/tools/lorem-ipsum	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/lorem-ipsum
POST /v1/tools/base-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/base-converter
POST /v1/tools/text-to-speech	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/text-to-speech
POST /v1/tools/screen-recorder	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/screen-recorder
POST /v1/tools/video-to-gif	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-to-gif
POST /v1/tools/video-compress	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-compress
POST /v1/tools/mp4-to-webm	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/mp4-to-webm
POST /v1/tools/video-trim	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-trim
POST /v1/tools/video-to-audio	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-to-audio
POST /v1/tools/video-merge	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-merge
POST /v1/tools/video-resize	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-resize
POST /v1/tools/social-video-toolkit	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/social-video-toolkit
POST /v1/tools/video-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/video-converter
POST /v1/tools/gif-to-mp4	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/gif-to-mp4
POST /v1/tools/pdf-to-images-zip	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/pdf-to-images-zip
POST /v1/tools/ico-to-png	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ico-to-png
POST /v1/tools/timezone-converter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/timezone-converter
POST /v1/tools/csv-excel	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/csv-excel
POST /v1/tools/yaml-json	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/yaml-json
POST /v1/tools/xml-json	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/xml-json
POST /v1/tools/markdown-html	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/markdown-html
POST /v1/tools/html-markdown	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/html-markdown
POST /v1/tools/cron-parser	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/cron-parser
POST /v1/tools/subnet-calculator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/subnet-calculator
POST /v1/tools/ip-lookup	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/ip-lookup
POST /v1/tools/json-diff	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/json-diff
POST /v1/tools/csv-diff	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/csv-diff
POST /v1/tools/barcode-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/barcode-generator
POST /v1/tools/markdown-table	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/markdown-table
POST /v1/tools/slug-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/slug-generator
POST /v1/tools/text-encrypt	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/text-encrypt
POST /v1/tools/vcard-generator	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/vcard-generator
POST /v1/tools/json-to-ts	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/json-to-ts
POST /v1/tools/sql-formatter	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/sql-formatter
POST /v1/tools/minifier	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/minifier
POST /v1/tools/contrast-checker	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/contrast-checker
POST /v1/tools/zip-tool	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/zip-tool
POST /v1/tools/bulk-rename	multipart	free	browser-only	Not available server-side: This conversion requires a browser runtime or an external conversion provider; use /tools/bulk-rename

Errors

400: missing / invalid input
401: missing or malformed Authorization header
402: invalid API key or insufficient api_credits
404: unknown tool slug
413: file too large
429: rate limit exceeded (60 requests per minute per key); see the Retry-After header
501: tool is browser-only (credits refunded)
502: upstream provider failure (credits refunded)

Get an API key

Generate and manage keys in your dashboard. Purchase API credits any time.

See API pricing Go to dashboard