# ImageKit AI integration on Definable

> ImageKit.io is a comprehensive media management solution offering real-time image and video optimization, transformation, and delivery through a global content delivery network (CDN).

## What this connects

ImageKit.io is a comprehensive media management solution offering real-time image and video optimization, transformation, and delivery through a global content delivery network (CDN).

Vendor: https://imagekit.io/

## Tools available

**26** tools available. First 12:

- `IMAGEKIT_IO_BULK_JOB_STATUS` — Bulk Job Status — Retrieve the status of a bulk folder operation. Use this tool to monitor the progress of asynchronous Copy Folder or Move Folder operations by providing the jobId returned from those operations.
- `IMAGEKIT_IO_BULK_MOVE_FILES` — Bulk Move Files — Tool to move multiple files in bulk. Use when you need to relocate up to 100 ImageKit files to a specified folder in one API call.
- `IMAGEKIT_IO_BULK_REMOVE_TAGS` — Bulk Remove Tags — Tool to remove tags from multiple files in bulk. Use when you need to strip specified tags from up to 50 existing files in one API call.
- `IMAGEKIT_IO_COPY_FOLDER` — 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.
- `IMAGEKIT_IO_CREATE_CUSTOM_METADATA_FIELD` — Create Custom Metadata Field — Create a new custom metadata field in ImageKit DAM. Use this tool to define custom metadata fields that can be attached to assets (images, videos, etc.) in your ImageKit media library. Once created, you can assign values to these fields on individual assets for better organization and searchability. Supported field types: - Text/Textarea: For string values with optional length constraints - Number: For numeric values with optional min/max constraints - Date: For ISO8601 date strings with optional date range constraints - Boolean: For true/false values - SingleSelect/MultiSelect: For predefined options (requires selectOptions) Note: Field names must be unique across all fields (including deleted ones). Field types cannot be changed after creation.
- `IMAGEKIT_IO_CREATE_FOLDER` — 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.
- `IMAGEKIT_IO_DELETE_CUSTOM_METADATA_FIELD` — Delete Custom Metadata Field — Permanently deletes a custom metadata field from ImageKit. This action is irreversible. Note: Even after deletion, you cannot create a new field with the same name. Use 'List Custom Metadata Fields' first to get the field ID if needed. Rate limit: 5 requests/second for custom metadata field operations.
- `IMAGEKIT_IO_DELETE_FILE` — 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.
- `IMAGEKIT_IO_DELETE_FILE_VERSION` — Delete File Version — Permanently deletes a specific non-current file version from ImageKit.io. Use this when you need to remove an older version of a file while keeping the current version intact. Note: This action is irreversible. To delete all versions of a file, use the Delete File action instead.
- `IMAGEKIT_IO_DELETE_FOLDER` — Delete Folder — Permanently delete a folder and all its contents from ImageKit Media Library. WARNING: This is a destructive operation that cannot be undone. All files and subfolders within the specified folder will be permanently removed. Use this when you need to: - Remove an entire folder structure - Clean up unused folders - Delete test/temporary folders The operation is idempotent - deleting a non-existent folder will not raise an error.
- `IMAGEKIT_IO_DELETE_MULTIPLE_FILES` — Delete Multiple Files — Permanently delete multiple files from ImageKit media library in a single batch operation. Use this tool when you need to: - Remove up to 100 files at once by their unique file IDs - Clean up unused assets from your media library - Bulk delete files after migration or reorganization Important notes: - Deletion is permanent and includes all file versions - Cached CDN responses are NOT automatically purged (use Purge Cache action if needed) - File IDs can be obtained from 'List and Search Assets' or upload responses Returns the list of successfully deleted file IDs. On partial success (some files deleted, some failed), also returns an errors array with per-file failure details.
- `IMAGEKIT_IO_GET_AUTHENTICATION_PARAMETERS` — Get Upload Authentication Parameters — Tool to generate authentication parameters for client-side file uploads. Use when preparing client-side uploads.

## Auth

Auth schemes: `API_KEY`.

## How agents use ImageKit

Inside a Definable workflow, ImageKit is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → ImageKit** — the Researcher (GPT-5.5) pulls context from ImageKit (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → ImageKit** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into ImageKit (create record, post message, draft email).
- **Designer / Engineer → Distributor → ImageKit** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via ImageKit (attach file, open PR comment, post status).

The Verifier checks every ImageKit call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- images & design — https://definable.ai/apps/category/images-&-design/
- file management & storage — https://definable.ai/apps/category/file-management-&-storage/

## Related

- HTML page: https://definable.ai/apps/imagekit_io/
- Same category (images & design): https://definable.ai/apps/category/images-&-design/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
