# Imgix

imgix is a real-time image processing and delivery service that enables developers to optimize, transform, and deliver images efficiently.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 53
- **Triggers:** 0
- **Slug:** `IMGIX`
- **Version:** 20260413_00

## Tools

### IMGIX_ADD_ASSET_FROM_ORIGIN

**Slug:** `IMGIX_ADD_ASSET_FROM_ORIGIN`

Tool to queue a path from your origin to be added to the Asset Manager. Imports the asset metadata without uploading the asset itself. Use when you need to register an existing origin-hosted file with imgix.

### Imgix Auto Optimization

**Slug:** `IMGIX_AUTO`

Apply automatic image optimizations using imgix's auto parameter. Use this tool to automatically optimize images for web delivery. Common use cases: - Reduce file sizes with 'compress' for faster page loads - Auto-select modern formats (AVIF/WebP) with 'format' based on browser support - Enhance image quality with 'enhance' (adjusts brightness, contrast, saturation) - Remove red-eye from portrait photos with 'redeye' Multiple options can be combined (e.g., ['compress', 'format']) for cumulative optimizations. The 'true' option is a convenient shorthand that applies 'enhance' automatically. Note: This tool works with the imgix Rendering API and requires a valid imgix source domain. For testing, use 'assets.imgix.net' with paths like 'examples/kingfisher.jpg'.

### Blend Overlay

**Slug:** `IMGIX_BLEND`

Tool to overlay an image, text, or color onto a base image using imgix blending parameters. Use after specifying the base image URL and blend parameters to composite layers.

### Imgix Blend Align

**Slug:** `IMGIX_BLEND_ALIGN`

Tool to align the overlay relative to the base image when blending. Use after constructing a base Imgix URL to specify horizontal and vertical alignment (e.g., 'left,top').

### Blend Color Over Image

**Slug:** `IMGIX_BLEND_COLOR`

Tool to blend a solid color over an image using CSS keyword or hex. Use when you need to apply color overlay transformations to an existing image URL.

### Imgix Blend X Position

**Slug:** `IMGIX_BLEND_X`

Position an overlay image horizontally on a base image using imgix's blend-x parameter. Use this tool when you need to place an overlay (image or color) at a specific horizontal offset from the left edge of the base image. This is useful for creating watermarks, badges, or composite images where precise positioning is required. Note: The blend-x parameter only affects image overlays. Color overlays always cover the entire image regardless of this setting.

### Draw Image Border

**Slug:** `IMGIX_BORDER`

Tool to draw a border around an image. Use when you need to overlay a border without resizing.

### Adjust Image Brightness

**Slug:** `IMGIX_BRI`

Tool to adjust image brightness. Use when you need to modify an image's brightness level (−100 to 100) by supplying your source domain and asset path.

### IMGIX_CANCEL_UPLOAD_SESSION

**Slug:** `IMGIX_CANCEL_UPLOAD_SESSION`

Tool to cancel an Imgix Asset Manager upload session. Use when you need to abort an in-progress or abandoned upload flow and clean up the session.

### IMGIX_CH

**Slug:** `IMGIX_CH`

Tool to opt in to Client Hints. Use when you want Imgix URLs to adapt based on browser headers (Width, DPR, Save-Data).

### IMGIX_CLOSE_UPLOAD_SESSION

**Slug:** `IMGIX_CLOSE_UPLOAD_SESSION`

Tool to close an Imgix Asset Manager upload session after the client uploads to the presigned URL. Use after uploading a file to expedite asset processing. Closing is strongly recommended by imgix.

### Adjust Image Contrast

**Slug:** `IMGIX_CON`

Tool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).

### IMGIX_CREATE_IMGIX_SOURCE

**Slug:** `IMGIX_CREATE_IMGIX_SOURCE`

Tool to create and deploy a new imgix Source. Use when you need to add a new image source with deployment configuration for S3, Web Folder, Web Proxy, GCS, Azure, or S3-compatible storage. Requires source name and deployment details with type-specific credentials and settings.

### IMGIX_CREATE_UPLOAD_SESSION

**Slug:** `IMGIX_CREATE_UPLOAD_SESSION`

Tool to create an Imgix Asset Manager upload session and return a presigned URL for client-side upload. Use when you need to upload a new image to a storage-backed imgix Source without requiring external hosting. Client performs HTTP PUT of file bytes to the presigned URL, then calls IMGIX_CLOSE_UPLOAD_SESSION to finalize.

### IMGIX_CS

**Slug:** `IMGIX_CS`

Tool to set or strip output color space/profile on an Imgix image. Use when optimizing compatibility and file size (e.g., cs=strip for smaller metadata).

### IMGIX_DL

**Slug:** `IMGIX_DL`

Download an asset from an Imgix source with optional custom filename. Use this tool when you need to: - Download images or assets from an Imgix CDN source - Force a specific download filename (via 'dl' parameter) - Download assets with special character filenames (via 'dl64' parameter) The asset is fetched from the Imgix CDN and returned as a downloadable file reference. If neither 'dl' nor 'dl64' is specified, the original filename from the path is used.

### Adjust Image DPI

**Slug:** `IMGIX_DPI`

Tool to embed DPI (dots-per-inch) metadata for print output on an Imgix-rendered image. Use when preparing images for print to set accurate DPI. Supports JPEG and PNG only.

### Set Device Pixel Ratio

**Slug:** `IMGIX_DPR`

Tool to set device pixel ratio for an Imgix image. Use when rendering at specific display densities to ensure correct sharpness. Example: 'dpr=2&w=500&h=300' doubles resolution relative to dimensions.

### Imgix URL Expiration

**Slug:** `IMGIX_EXPIRES`

Tool to append an expiration parameter to an Imgix URL so it returns 404 after a given time. Use when you want the image URL to stop serving beyond a specific UNIX timestamp.

### IMGIX_FIT

**Slug:** `IMGIX_FIT`

Tool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.

### IMGIX_FM

**Slug:** `IMGIX_FM`

Tool to choose output file format for the rendered asset. Use after specifying the asset path when you need to convert its format.

### Force Aspect Ratio

**Slug:** `IMGIX_FORCE_ASPECT_RATIO`

Tool to force a target aspect ratio on an Imgix image. Use when a specific W:H frame is needed after choosing fit=crop or fit=fill. Example: 'ar=16:9&fit=crop&w=800' yields a 16:9, 800px-wide URL.

### IMGIX_GET_SOURCE

**Slug:** `IMGIX_GET_SOURCE`

Tool to retrieve details for a single imgix Source by its ID. Returns the source configuration including deployment status, type, and settings.

### IMGIX_GET_UPLOAD_SESSION_STATUS

**Slug:** `IMGIX_GET_UPLOAD_SESSION_STATUS`

Tool to retrieve the status of an Imgix Asset Manager upload session. Use when you need to check the current state (PENDING/CLOSED/COMPLETE/CANCELED) of an upload session for polling or verification after client PUT and/or after closing.

### IMGIX_H

**Slug:** `IMGIX_H`

Tool to set output image height in pixels or as a ratio of the source height. Use after constructing an Imgix URL to adjust only height.

### Adjust Image Highlights

**Slug:** `IMGIX_HIGH`

Tool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.

### IMGIX_LIST_ASSETS

**Slug:** `IMGIX_LIST_ASSETS`

Tool to retrieve a paginated list of assets in an imgix Source. Use when you need to list, filter, or search assets with cursor-based pagination and sorting.

### IMGIX_LIST_REPORTS

**Slug:** `IMGIX_LIST_REPORTS`

Tool to retrieve a list of all available reports for your imgix account. Use when you need to access analytics and usage information. Reports are generated daily and retained for 90 days.

### IMGIX_LIST_SOURCES

**Slug:** `IMGIX_LIST_SOURCES`

Tool to list all Sources for an account. Use when you need to retrieve and paginate through sources with optional sorting and filtering.

### Set Watermark Base URL

**Slug:** `IMGIX_MARK_BASE`

Tool to set the base URL prepended to the watermark image path. Use when you need to host watermark assets on a custom domain or CDN.

### Watermark Fit Mode

**Slug:** `IMGIX_MARK_FIT`

Tool to set how a watermark fits its target dimensions. Use when applying a watermark and you need control over fitting behavior (e.g., selecting 'scale'). For 'crop', ensure 'mark-w' and 'mark-h' are also provided.

### Imgix Mark Height

**Slug:** `IMGIX_MARK_H`

Tool to set watermark height on an Imgix URL in pixels or as a ratio of the watermark source. Use when adjusting overlay height while preserving aspect ratio.

### IMGIX_MARK_PAD

**Slug:** `IMGIX_MARK_PAD`

Tool to set pixel padding between a watermark and the image edge or between tiled watermarks. Use after configuring watermark URL and alignment to adjust spacing precisely.

### Watermark Width

**Slug:** `IMGIX_MARK_W`

Tool to set watermark width. Use when you need to enforce a watermark's width in pixels or as a proportion. Use after specifying watermark source.

### IMGIX_MASK

**Slug:** `IMGIX_MASK`

Tool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.

### IMGIX_MAX_H

**Slug:** `IMGIX_MAX_H`

Constrain the maximum height of an imgix image. This tool applies fit=crop along with the max-h parameter to ensure images do not exceed the specified height. Ideal for vertically-scrolling feeds or galleries where user-uploaded images may have unpredictable heights. Returns a downloadable image URL.

### IMGIX_MAX_W

**Slug:** `IMGIX_MAX_W`

Tool to set the maximum output width on an Imgix URL. Use when you need to cap width (works only with fit=crop). Call after specifying fit=crop on the URL.

### IMGIX_PALETTE

**Slug:** `IMGIX_PALETTE`

Tool to extract a color palette from an image in CSS or JSON form. Use when you need to analyze an image's dominant colors after any transformations.

### Set CSS Palette Prefix

**Slug:** `IMGIX_PREFIX`

Tool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.

### IMGIX_PURGE_ASSET

**Slug:** `IMGIX_PURGE_IMGIX_ASSET`

Tool to purge an asset from the imgix cache. Use when you need to invalidate cached versions of an image and force imgix to fetch a fresh version from origin on the next request.

### Set Output Quality

**Slug:** `IMGIX_Q`

Tool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.

### IMGIX_RECT

**Slug:** `IMGIX_RECT`

Tool to select a source-image rectangle region in Imgix before other resizing. Use when you need to crop a specific region (x,y,w,h) of the source image.

### Imgix Rotate

**Slug:** `IMGIX_ROT`

Tool to rotate an image on Imgix. Use when you need to apply a counter-clockwise rotation (0–359°) with optional mode control.

### IMGIX_ROT_TYPE

**Slug:** `IMGIX_ROT_TYPE`

Tool to control rotation behavior when `rot` is applied. Use after applying a `rot` parameter to choose between pivot (show entire image) or straighten (zoom and crop) behavior.

### Text Overlay

**Slug:** `IMGIX_TXT`

Tool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.

### IMGIX_TXT_ALIGN

**Slug:** `IMGIX_TXT_ALIGN`

Tool to align a text overlay on an Imgix image. Use when you need to position text by specifying vertical (top/middle/bottom) and horizontal (left/center/right) alignment.

### Set Text Color

**Slug:** `IMGIX_TXT_COLOR`

Tool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.

### Set Text Font

**Slug:** `IMGIX_TXT_FONT`

Tool to choose font family/style for overlay text. Use when customizing text appearance after specifying content. Supports CSS font categories and optional bold/italic flags.

### Set Text Outline Width

**Slug:** `IMGIX_TXT_LINE`

Tool to set outline width around overlay text. Use when styling text overlays on images.

### Text Outline Color

**Slug:** `IMGIX_TXT_LINE_COLOR`

Apply an outline color to text overlays on Imgix images. The text outline must first be enabled using the txt-line parameter (outline width > 0). This action fetches and returns the rendered image with the specified outline color applied.

### IMGIX_TXT_SHAD

**Slug:** `IMGIX_TXT_SHAD`

Set text shadow strength for imgix text overlays. The txt-shad parameter controls the drop shadow intensity (0-10) applied to text rendered on images. Note: This parameter only has a visible effect when combined with text overlay parameters (e.g., txt parameter). Use this action to add depth and visibility to text overlays on images.

### IMGIX_TXT_SIZE

**Slug:** `IMGIX_TXT_SIZE`

Tool to set text font size in pixels. Use when overlaying text and needing precise control over font size. Specify after defining the text content; default is 12px.

### IMGIX_UPDATE_SOURCE

**Slug:** `IMGIX_UPDATE_SOURCE`

Tool to update an existing imgix Source. Use when you need to modify source name, deployment configuration, bucket settings, or other source attributes. Deployment changes trigger automatic redeployment.