Quick start

Create a ToolGrid account and sign in.
Open Dashboard → TOOLGRID API GATEWAY → Keys and create a named key. Copy the secret immediately — it is shown only once.
Store the key on your server (environment variable). Do not embed secrets in public browser JavaScript, mobile app bundles, or public repositories.
Purchase API credits from Credits. This wallet is separate from AI credits.
Call POST /v1/execute with Bearer auth, an Idempotency-Key, and multipart fields tool + file. For multiple files, use batch jobs (POST /v1/jobs). Or try interactively in the testing console (Single or Batch mode).
Read request_id, result, and billing from the JSON response.
Inspect usage and ledger history in the developer dashboard.

Minimal cURL

The API is language-agnostic HTTPS. Use cURL below, or copy Node.js, Python, Go, PHP, Java, C#, or Ruby snippets from the developers landing page.

export TOOLGRID_API_BASE="https://api.toolgrid.io"
export TOOLGRID_API_KEY="tg_api_YOUR_SECRET"

curl -X POST "$TOOLGRID_API_BASE/v1/execute" \
  -H "Authorization: Bearer $TOOLGRID_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "tool=pdf_text_extraction" \
  -F "file=@document.pdf"

Next: Testing console · Batch jobs · Authentication

Quick start

Create a ToolGrid account and sign in.
Open Dashboard → TOOLGRID API GATEWAY → Keys and create a named key. Copy the secret immediately — it is shown only once.
Store the key on your server (environment variable). Do not embed secrets in public browser JavaScript, mobile app bundles, or public repositories.
Purchase API credits from Credits. This wallet is separate from AI credits.
Call POST /v1/execute with Bearer auth, an Idempotency-Key, and multipart fields tool + file. For multiple files, use batch jobs (POST /v1/jobs). Or try interactively in the testing console (Single or Batch mode).
Read request_id, result, and billing from the JSON response.
Inspect usage and ledger history in the developer dashboard.

Minimal cURL

The API is language-agnostic HTTPS. Use cURL below, or copy Node.js, Python, Go, PHP, Java, C#, or Ruby snippets from the developers landing page.

export TOOLGRID_API_BASE="https://api.toolgrid.io"
export TOOLGRID_API_KEY="tg_api_YOUR_SECRET"

curl -X POST "$TOOLGRID_API_BASE/v1/execute" \
  -H "Authorization: Bearer $TOOLGRID_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "tool=pdf_text_extraction" \
  -F "file=@document.pdf"

Next: Testing console · Batch jobs · Authentication