Quickstart
Get an API key from the dashboard and call your first tool in minutes.
This guide covers the tool API only. Account signup, plans, and API keys are managed in the ToolYour dashboard.
Prerequisites
- A ToolYour account with a verified email
- An active plan (Free tier works — 500 requests/month)
- An API key from Dashboard → API Keys
curlor any HTTP client
Base URL for all tool calls:
https://api.toolyour.comStep 1 — Get your API key
- Sign in at toolyour.com
- Open Dashboard → API Keys
- Create a key and copy the secret (starts with
ty_)
Store it securely — treat it like a password. Never expose it in browser code or public repos.
Step 2 — Call a tool
Example: text case converter (JSON body):
curl -X POST "https://api.toolyour.com/api/v1/text-utilities/text-case-converter" \
-H "Content-Type: application/json" \
-H "X-Api-Key: ty_YOUR_KEY_HERE" \
-d '{"text":"hello world","case":"uppercase"}'Example: document conversion (file upload):
curl -X POST "https://api.toolyour.com/api/v1/documents/docx-to-pdf" \
-H "X-Api-Key: ty_YOUR_KEY_HERE" \
-F "file=@report.docx" \
-o report.pdfStep 3 — Monitor usage
Check Dashboard → Overview or API Keys for monthly usage. All keys share your account quota — see Usage & Plans.
Next steps
- Account & API Keys — plans, key limits, shared quota
- Calling Tools — JSON vs multipart, response formats
- Tool APIs — browse categories
- OpenAPI in the sidebar — full request/response schemas for every tool endpoint