ImageKit icon

ImageKit

Media management and delivery service for files, folders, bulk operations, custom metadata fields, and async copy jobs.

Covers media-heavy apps that organize assets into folders, run bulk move or tag operations, attach custom metadata, and monitor async folder jobs.

Example Use Cases

These are the ImageKit actions Snow can use when building apps with you. Connecting an account does not make Snow run these on its own.

Copy Folder

Initiate an asynchronous bulk copy of a folder and all its contents to a new location. Use this tool when you need to: - Duplicate an entire folder structure including all nested files and subfolders - Create a backup of a folder at a different location - Copy a folder with or without file version history This is an asynchronous operation that returns immediately with a job ID. The actual copy happens in the background. Use IMAGEKIT_IO_BULK_JOB_STATUS with the returned jobId to check when the operation completes. Note: If a folder with the same name exists at the destination, permissions from the existing destination folder will be preserved.

Create Folder

Creates a new folder in ImageKit.io media library. Use this to organize assets into structured folder hierarchies. The folder will be created at the specified parent path. If the parent folder doesn't exist, the API will return an error.

Delete File

Permanently deletes a file from ImageKit by its unique file ID. WARNING: This action is irreversible. The file and all its versions will be permanently removed. Note: Cached versions of the file may still be served until the cache expires. Use the purge cache endpoint if immediate removal from CDN is required. Use this tool when you need to: - Remove unwanted or obsolete files from the media library - Clean up test uploads - Delete files that should no longer be accessible The file ID can be obtained from the 'List and Search Assets' or 'Upload File' actions.

Get File Details

Tool to retrieve details of a specific file. Use after uploading or listing assets to get full metadata.

Get Upload Authentication Parameters

Tool to generate authentication parameters for client-side file uploads. Use when preparing client-side uploads.

Get Usage

Retrieve ImageKit account usage metrics for a specified date range. Returns bandwidth consumption and media library storage usage. The response includes data from startDate up to (but not including) endDate. Maximum allowed date range is 90 days.

List and Search Media Assets

List and search media assets (files, folders, file-versions) in your ImageKit media library. Use this tool to: - Browse all assets with optional pagination (limit/skip) - Filter by type (file, folder, file-version, or all) - Filter by name, tags, or file type (image/non-image) - Search with advanced Lucene-style queries (e.g., 'size > 1000000 AND tags IN

Move Folder

Move a folder from one location to another in your ImageKit media library. This operation is asynchronous - it returns a jobId immediately, and the actual move happens in the background. The folder will be moved to become a subfolder of the destination path. Use IMAGEKIT_IO_BULK_JOB_STATUS with the returned jobId to check if the move has completed. Example: Moving '/photos/summer' to '/archive' will result in '/archive/summer'.

Rename File

Renames an existing file in the ImageKit media library. Use this action when you need to change a file's name. Important: Old URLs will stop working after rename (unless CDN cache is active). This operation renames all file versions. Set purgeCache=True to clear CDN cached content for the old URL. Returns 404 if file not found, 409 if a file with the new name already exists in the same folder.

Update File Details

Update file details in ImageKit media library. Use this tool to modify tags, custom coordinates, custom metadata, AI tags, apply extensions (like background removal), or change publication status. Note: When updating publication status via 'publish', no other parameters can be included in the request.