TOOLGRID API GATEWAY

Versioned HTTP API for server-to-server tool execution. Authenticate with a Developer API key, call POST /v1/execute for a single file or POST /v1/jobs for async multi-file batch, and pay with a prepaid API credit wallet. Works with any language that can send HTTPS multipart requests — not limited to Node.js.

Open testing console Quick start

Base URL: your API host (local typically http://localhost:5000; production HTTPS)

Execute: POST /v1/execute

Batch jobs: POST /v1/jobs

Auth: Authorization: Bearer tg_api_…

Required header: Idempotency-Key

Example

curl -X POST "$TOOLGRID_API_BASE/v1/execute" \
  -H "Authorization: Bearer tg_api_YOUR_SECRET" \
  -H "Idempotency-Key: YOUR_UNIQUE_KEY" \
  -F "tool=background_removal" \
  -F "file=@photo.jpg"

Pricing clusters (11)

Tools inherit a cluster rate (1 credit = $0.0001). Full list on pricing clusters. Discover tool IDs via GET /v1/tools or the testing console.

Developer Utilities · 15 credits ($0.0015)
File Conversion · 50 credits ($0.005)
Calculators · 5 credits ($0.0005)
Image Processing · 80 credits ($0.008)
Document Processing · 50 credits ($0.005)
ToolGrid.io Flows · 100 credits ($0.01)
Text & Writing · 10 credits ($0.001)
Generators · 10 credits ($0.001)
Time & Date · 5 credits ($0.0005)
Fun & Games · 5 credits ($0.0005)
Web Utilities · 20 credits ($0.002)

Testing console · Quick start · Authentication · Billing · Batch jobs · Errors