REST API Reference

HTTP access to Dev Tools ! — a catalog of 57 tools, 13 of which run server-side, plus the chat, contact, subscribe, flags, and health endpoints the web app itself uses.

Preview availability

The API runs in the Cosyslabs shared backend, but the public host is not open to everyone yet — a request may not reach it today. The shapes documented below are what the service actually returns. Ask for access and tell us what you are building.

Base URL

https://api.devtoolzy.com/devtoolzy/api

Endpoint paths below include the /devtoolzy/api prefix in full. There is no version segment in the path.

Authentication

The catalog, tool-run, flags, and health endpoints are open — no key. /chat, /contact, and /subscribe require a key and answer 401 without one:

X-Api-Key: your_key_here

Request an API key →

Rate Limits

Tool runs, chat, contact, and subscribe are each rate-limited per client IP. Over the limit you get 429 with an explanation in the detail field.

Specific per-endpoint numbers are deployment configuration and are not published while the API is in preview. Published tiers and X-RateLimit-* headers are planned for general availability — they do not exist today, so back off on a 429 rather than reading a header.

Endpoints

Click an endpoint to see request/response examples.

Error Format

Errors carry the HTTP status and a detail string. A 501 names the web URL to use instead:

{
  "detail": "'color-picker' runs entirely in the browser. Use https://devtoolzy.com/tools/design/color-picker instead."
}
401UnauthorizedAPI key missing or invalid on /chat, /contact, /subscribe404Not foundUnknown tool slug422UnprocessableInput rejected by the tool — bad JSON, unsupported algorithm, malformed JWT429Rate limitedToo many requests from this IP501Not implementedTool runs only in the browser500Internal errorServer error — safe to retry

More integration options