Error Handling & Troubleshooting
HTTP Status Codes
| Status Code | Meaning | Common Causes |
|---|---|---|
400 | Bad Request | Invalid/missing parameter, malformed JSON, etc. |
401 | Unauthorized | Missing or invalid API key. |
402 | Insufficient Credits | You lack the credits to proceed with the request. |
404 | Not Found | Requested job or resource doesn't exist; invalid URL for metadata. |
429 | Too Many Requests | Rate limiting or concurrency limit reached. |
500 | Internal Server Error | Unexpected server issue. Check status.importly.io if needed. |
Common Troubleshooting Tips
- Check URL Accessibility: If
/metadataor/importreturns a 404, confirm the media URL is publicly available. - API Key Validity: Rotate your key if you suspect it's expired or compromised.
- Insufficient Credits: Monitor usage in the dashboard and top up or upgrade your plan if needed.
Contact Support
If you're stuck, reach out to support@importly.io with:
- The jobId or request payload.
- Timestamps or logs for the failing requests.
- Any relevant code snippets.