ImageKit.io offers REST API so that you can programmatically integrate ImageKit.io in your application. Currently, we offer APIs for:
​Uploading files in the Media library.
​Updating files details, e.g., tags and custom coordinates for cropping.
​Listing and searching files in the Media library by file/folder name, tags.
​Deleting files.
​Purging cache on CDN.
​Getting image metadata for an image file.
​Get bulk job status for copy and move folder jobs.
Except for upload API, all our APIs accept JSON-encoded request bodies and returns JSON-encoded response.
We’ve created a Postman collection to make testing and working with our API simpler.
​​​​
ImageKit.io API uses standard HTTP error codes.
Error code | Description |
2xx OK | Everything worked as expected. |
400 Bad request | The request was unacceptable, often due to missing or invalid parameter(s). In this case a JSON-encoded error response is returned with the following properties: |
401 Unauthorized | No valid API key provided. |
429 Too Many Requests | Too many requests hit the API too quickly.
We recommend you to throttle request rate as per the
value of |
500, 502, 503, 504 Server error | Something went wrong with ImageKit.io API. Please create a support ticket by emailing us at support@imagekit.io. |
All API response contains a x-ik-requestId
header. The value of this header is a unique identifier associated with the API request. If you face any issues with any API, then provide this header value in your support ticket to help us troubleshoot the issue quickly.