# Imagekit io

```json
{
  "name": "Imagekit io",
  "slug": "imagekit_io",
  "url": "https://composio.dev/toolkits/imagekit_io",
  "markdown_url": "https://composio.dev/toolkits/imagekit_io.md",
  "logo_url": "https://imagekit.io/static/imagekit-logo.svg",
  "categories": [
    "entertainment & media"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:15:42.675Z"
}
```

![Imagekit io logo](https://imagekit.io/static/imagekit-logo.svg)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Imagekit io MCP or direct API to upload images, transform media, fetch optimized URLs, and manage assets through natural language.

## Summary

ImageKit.io is a cloud-based media management platform for image and video delivery. Instantly optimize, transform, and deliver visuals globally via a lightning-fast CDN.

## Categories

- entertainment & media

## Toolkit Details

- Tools: 26

## Images

- Logo: https://imagekit.io/static/imagekit-logo.svg

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for ImageKit.
  - Setup:
    - Configure Api Key credentials for ImageKit.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Move all event photos to new 2024 folder
- Delete outdated logo file from media library
- Create custom metadata field for copyright info
- Copy marketing assets folder to backup location

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `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. |
| `IMAGEKIT_IO_GET_FILE_DETAILS` | Get File Details | Tool to retrieve details of a specific file. Use after uploading or listing assets to get full metadata. |
| `IMAGEKIT_IO_GET_FILE_METADATA` | Get File Metadata | Tool to retrieve metadata of an uploaded file. Use after confirming a successful upload to get EXIF, pHash, dimensions, and other image metadata. |
| `IMAGEKIT_IO_GET_FILE_VERSION_DETAILS` | Get File Version Details | Tool to retrieve details of a specific file version. Use after listing or uploading assets when you need to inspect version metadata. |
| `IMAGEKIT_IO_GET_USAGE` | 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. |
| `IMAGEKIT_IO_LIST_AND_SEARCH_ASSETS` | 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 ["banner"]') - Sort results by name, date, size, or dimensions Returns a list of asset objects with metadata including URLs, dimensions, tags, and timestamps. |
| `IMAGEKIT_IO_LIST_CUSTOM_METADATA_FIELDS` | List Custom Metadata Fields | List all custom metadata fields defined in the ImageKit Media Library. Use this tool to: - Retrieve all metadata field definitions (name, label, type, constraints) - Get field IDs required for updating or deleting fields - View field configurations (required, default values, select options) - Include soft-deleted fields when needed for auditing |
| `IMAGEKIT_IO_LIST_FILE_VERSIONS` | List File Versions | Retrieves all versions of a specific file in ImageKit. Returns a list of file version objects including metadata like version ID, creation date, and publication status. Use this to view file history, compare versions, or find a specific version to restore. Requires a valid fileId which can be obtained from the List Assets API or Upload API response. |
| `IMAGEKIT_IO_MOVE_FOLDER` | 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'. |
| `IMAGEKIT_IO_PURGE_CACHE` | Purge ImageKit Cache | Purge CDN and ImageKit internal caches for a specific URL or URL pattern. Use this action when you need to: - Invalidate cached content after updating an image - Force CDN to fetch the latest version of a file - Clear cache for a directory using wildcard (*) Note: Cache purging is asynchronous. Use the returned requestId with IMAGEKIT_IO_PURGE_STATUS to check completion. Monthly purge limits apply based on your pricing plan (typically 1000 URLs/month). |
| `IMAGEKIT_IO_PURGE_STATUS` | Check purge cache status | Tool to check the status of a cache purge request. Use after initiating a purge to retrieve its current state. Example: "What's the status of purge request id abc123?" |
| `IMAGEKIT_IO_RENAME_FILE` | 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. |
| `IMAGEKIT_IO_RESTORE_FILE_VERSION` | Restore File Version | Restores a non-current file version to become the current version in ImageKit. Use this to revert a file to a previous state. First use the List File Versions API to find the versionId of the version you want to restore. |
| `IMAGEKIT_IO_UPDATE_CUSTOM_METADATA_FIELD` | Update Custom Metadata Field | Updates an existing custom metadata field's label or schema constraints in ImageKit DAM. Use this to: - Change the display label of a metadata field - Update validation constraints (min/max values, min/max length) - Set or modify the default value - Change whether the field is required Note: The field type and name cannot be changed after creation. At least one of 'label' or 'schema' must be provided in the request. |
| `IMAGEKIT_IO_UPDATE_FILE_DETAILS` | 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. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Imagekit io Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Imagekit io actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Move all event images to the 2024 folder'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Move all event images to the 2024 folder'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Imagekit io tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Move all assets from /uploads to /archive')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Move all assets from /uploads to /archive' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Imagekit io Integration

- Supports both Imagekit io MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for uploading, transforming, and managing your Imagekit io assets

### 2. Managed Auth

- Built-in API key handling with automatic credential rotation
- Central place to manage, scope, and revoke Imagekit io access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Imagekit io
- Scoped, least privilege access to Imagekit io resources
- Full audit trail of agent actions to support review and compliance

## Use Imagekit io with any AI Agent Framework

Choose a framework you want to connect Imagekit io with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/imagekit_io/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/imagekit_io/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/imagekit_io/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/imagekit_io/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/imagekit_io/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/imagekit_io/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/imagekit_io/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/imagekit_io/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/imagekit_io/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/imagekit_io/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/imagekit_io/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/imagekit_io/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/imagekit_io/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/imagekit_io/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/imagekit_io/framework/autogen)

## Related Toolkits

- [Youtube](https://composio.dev/toolkits/youtube) - YouTube is a leading video-sharing platform for uploading, streaming, and discovering content. It empowers creators and businesses to reach global audiences and monetize their work.
- [Amara](https://composio.dev/toolkits/amara) - Amara is a collaborative platform for creating and managing subtitles and captions for videos. It helps make content accessible and multilingual for global audiences.
- [Cats](https://composio.dev/toolkits/cats) - Cats is an API with a huge library of cat images, breed data, and cat facts. It makes finding adorable cat photos and trivia effortless for your apps and users.
- [Chatfai](https://composio.dev/toolkits/chatfai) - Chatfai is an AI platform that lets users talk to AI versions of fictional characters from books, movies, and games. It offers an engaging, interactive experience for fans to chat, roleplay, and explore creative dialogues.
- [Cincopa](https://composio.dev/toolkits/cincopa) - Cincopa is a multimedia platform for uploading, managing, and customizing videos, images, and audio. It helps you deliver engaging media experiences with robust APIs and flexible integrations.
- [Dungeon fighter online](https://composio.dev/toolkits/dungeon_fighter_online) - Dungeon Fighter Online (DFO) is an arcade-style, side-scrolling action RPG packed with dynamic combat and progression. Play solo or with friends to battle monsters, complete quests, and upgrade your characters.
- [Elevenlabs](https://composio.dev/toolkits/elevenlabs) - Elevenlabs is an advanced AI voice generation platform for lifelike, multilingual speech synthesis. Perfect for creating natural voices for videos, apps, and business content in seconds.
- [Elevenreader](https://composio.dev/toolkits/elevenreader) - Elevenreader is an AI-powered text-to-speech service by ElevenLabs that converts written content into lifelike audio. It enables fast, natural audio generation from any text.
- [Epic games](https://composio.dev/toolkits/epic_games) - Epic Games is a leading video game publisher and digital storefront, known for Fortnite and Unreal Engine. It lets gamers access, manage, and purchase games all in one place.
- [Fal.ai](https://composio.dev/toolkits/fal_ai) - Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools.
- [Giphy](https://composio.dev/toolkits/giphy) - Giphy is the largest online library for searching and sharing GIFs and stickers. Instantly add vibrant animated content to your apps, chats, and workflows.
- [Headout](https://composio.dev/toolkits/headout) - Headout is a global platform for booking travel experiences, tours, and entertainment. It helps users discover and secure activities at top destinations, all in one place.
- [Listennotes](https://composio.dev/toolkits/listennotes) - Listennotes is a powerful podcast search engine with a massive global database. Discover, search, and curate podcasts from around the world in seconds.
- [News api](https://composio.dev/toolkits/news_api) - News api is a REST API for searching and retrieving live news articles from across the web. Instantly access headlines, coverage, and breaking stories from thousands of sources.
- [RAWG Video Games Database](https://composio.dev/toolkits/rawg_video_games_database) - RAWG Video Games Database is the largest video game discovery and info service. Instantly access comprehensive details, ratings, and release dates for thousands of games.
- [Seat geek](https://composio.dev/toolkits/seat_geek) - SeatGeek is a live event platform offering APIs for concerts, sports, and theater data. Instantly access events, venues, and performers info for smarter ticketing and discovery.
- [Shotstack](https://composio.dev/toolkits/shotstack) - Shotstack is a cloud platform for programmatically generating videos, images, and audio. Automate creative content production at scale with flexible RESTful APIs.
- [Spotify](https://composio.dev/toolkits/spotify) - Spotify is a streaming service for music and podcasts with millions of tracks from artists worldwide. Enjoy personalized playlists, recommendations, and seamless listening across all your devices.
- [Ticketmaster](https://composio.dev/toolkits/ticketmaster) - Ticketmaster is a global platform for event discovery, ticket sales, and live entertainment management. Get real-time access to events and streamline ticketing for fans and organizers.
- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

## Frequently Asked Questions

### Do I need my own developer credentials to use Imagekit io with Composio?

Yes, Imagekit io requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)