HugMyTools API
REST API for programmatic file processing. All 49 tools are available via the same unified endpoint. API access requires a Pro plan or above.
Quick start
All API requests require a Bearer token obtained from the login endpoint. Pass it in the Authorization header.
# 1. Get an access token
curl -X POST https://api.hugmytools.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"yourpassword"}'
# 2. Submit a file for processing
curl -X POST https://api.hugmytools.com/api/v1/upload/process \
-H "Authorization: Bearer <access_token>" \
-F "tool_slug=compress-pdf" \
-F 'options={"quality":"balanced"}' \
-F "file=@/path/to/document.pdf"
# 3. Poll for status
curl https://api.hugmytools.com/api/v1/upload/status/<task_id> \
-H "Authorization: Bearer <access_token>"
# 4. Download the result
curl -O "https://api.hugmytools.com/api/v1/upload/result/<task_id>?tool_slug=compress-pdf" \
-H "Authorization: Bearer <access_token>"
Authentication endpoints
Access tokens expire after 15 minutes. The login endpoint also sets an httpOnly refresh_token cookie.
/api/v1/auth/register
Register a new account
/api/v1/auth/login
Sign in — returns access token + sets refresh cookie
/api/v1/auth/refresh
Exchange refresh cookie for new access token
/api/v1/auth/logout
Revoke current session
/api/v1/auth/verify-email
Verify email address with ?token= from email
/api/v1/auth/forgot-password
Request a password-reset link (rate limited: 3/min)
/api/v1/auth/reset-password
Set a new password using reset token from email
/api/v1/auth/change-password
Change password (requires current password)
File processing endpoints
All 49 tools share one endpoint. Pass the tool_slug to select which operation to run.
/api/v1/upload/process
Submit file for processing (multipart/form-data)
/api/v1/upload/status/{task_id}
Poll task status
/api/v1/upload/result/{task_id}
Download the processed file
Rate limits & tier limits
Ready to integrate?
API access is available on Pro and above. Start free and upgrade when you're ready.