OpenAPI Specification

Download the spec

The OpenAPI 3.1 spec lives at:

URL

https://cleverutils.com/api/v1/openapi.json

You can download it directly with cURL:

cURL

curl -O https://cleverutils.com/api/v1/openapi.json

Generate a client SDK

Use openapi-generator to scaffold a typed client in any language. Examples:

Python client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g python \
  -o ./cleverutils-python-client

TypeScript client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g typescript-fetch \
  -o ./cleverutils-ts-client

Go client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g go \
  -o ./cleverutils-go-client

Import into Postman / Insomnia

Postman: File → Import → Link, paste https://cleverutils.com/api/v1/openapi.json
Insomnia: Import → From URL, same URL
Bruno: Collection → Import → OpenAPI v3 Spec

Interactive Swagger UI

Browse and try endpoints right in your browser:

Swagger UI is loaded on demand. Click the button below to render the interactive API explorer. We don't auto-load it to keep this page lightweight.

Spec coverage

The OpenAPI spec describes:

POST /api/v1/convert — universal file converter (143+ format pairs)
POST /api/v1/batch — multi-file batch endpoint (up to 20 files)
GET /api/v1/jobs/{job_id} — job status polling
GET /api/v1/jobs/{job_id}/output — download converted file
GET /api/v1/batches/{batch_id} — aggregated batch status
POST /api/v1/tools/{slug} — specialized tools (AI, edit, PDF) — 45+ slugs
GET /api/v1/health — service health probe
GET /api/v1/limits — current rate-limit usage

Versioning

The spec is versioned along with the API. Breaking changes will go in a new /api/v2/openapi.json with at least 6 months of notice. Backwards-compatible changes (new endpoints, new optional fields) land in v1 immediately.