# 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:** 54
- **Triggers:** 0
- **Slug:** `IMGIX`
- **Version:** 20260316_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The unique identifier of the source where the asset will be added. |
| `origin_path` | string | Yes | The origin path of the asset to add, e.g., 'test/sample.jpg'. This path references an existing file on your origin that will be queued for import into the Asset Manager without uploading the file itself. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `auto` | array | Yes | List of automatic optimization operations to apply. Values can be combined. Options: 'compress' (reduces file size via aggressive compression), 'enhance' (auto-adjusts brightness, contrast, saturation), 'format' (auto-selects optimal format like AVIF/WebP based on browser support), 'redeye' (removes red-eye from detected faces), 'true' (shorthand that applies enhance and conditionally redeye if crop=faces is set). |
| `path` | string | Yes | Path to the image asset within the source. For the public demo source (assets.imgix.net), example paths include 'examples/kingfisher.jpg', 'examples/blueberries.jpg', 'examples/pione.jpg', 'examples/butterfly.jpg'. |
| `source` | string | Yes | Imgix source domain. Use your configured source subdomain (e.g., 'my-source.imgix.net') or the public demo source 'assets.imgix.net' for testing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blend` | string | No | URL-encoded overlay URL (image or text), absolute or relative. |
| `blend64` | string | No | URL-safe Base64-encoded overlay URL (image or text). |
| `blend_h` | number | No | Overlay height in pixels (>1) or ratio of base height (0.0-1.0) |
| `blend_w` | number | No | Overlay width in pixels (>1) or ratio of base width (0.0-1.0) |
| `blend_x` | integer | No | Horizontal offset in pixels from the left edge |
| `blend_y` | integer | No | Vertical offset in pixels from the top edge |
| `blend_fit` | string ("clamp" | "clip" | "crop" | "max" | "scale") | No | How the overlay is fit into its blend_w/blend_h box |
| `blend_pad` | integer | No | Padding in pixels around the overlay when alignment is used |
| `blend_crop` | string | No | When blend_fit='crop', crop focus: top, bottom, left, right, faces; CSV |
| `blend_mode` | string ("normal" | "darken" | "multiply" | "burn" | "lighten" | "screen" | "dodge" | "overlay" | "softlight" | "hardlight" | "difference" | "exclusion" | "color" | "hue" | "saturation" | "luminosity") | No | How the overlay interacts with the base image. |
| `blend_size` | string | No | If 'inherit', overlay inherits base image sizing/cropping |
| `blend_align` | string | No | Overlay alignment: top, middle, bottom, left, center, right or 'horizontal,vertical'. |
| `blend_alpha` | integer | No | Overlay transparency (0 transparent, 100 opaque). |
| `blend_color` | string | No | Solid color overlay; accepts keywords or hex strings (3/4/6/8-digit AARRGGBB). |
| `base_image_url` | string | Yes | The URL of the base image to which the overlay will be applied |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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').

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vertical` | string ("top" | "middle" | "bottom") | No | Vertical alignment of the overlay relative to the base image |
| `image_url` | string | Yes | The Imgix image URL to which the blend-align parameter will be applied |
| `horizontal` | string ("left" | "center" | "right") | No | Horizontal alignment of the overlay relative to the base image |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_url` | string | Yes | Source image URL |
| `blend_mode` | string ("normal" | "darken" | "multiply" | "burn" | "lighten" | "screen" | "dodge" | "overlay" | "softlight" | "hardlight" | "difference" | "exclusion" | "color" | "hue" | "saturation" | "luminosity") | No | How the color blends with the image; default is 'overlay' |
| `blend_alpha` | integer | No | Overlay transparency from 0 (transparent) to 100 (opaque) |
| `blend_color` | string | Yes | Color keyword or 3-/4-/6-/8-digit hex; for hex, prefix with '#' optional; 4/8-digit include alpha channel |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blend` | string | Yes | Overlay image URL (must also be on an imgix-enabled domain) or a hex color code (e.g., 'FF0000' for red). This enables blending on the base image. |
| `blend_x` | integer | No | Horizontal offset in pixels from the left edge of the base image where the blend overlay will be positioned. Defaults to 0 (left edge). Only applies to image overlays, not color overlays. |
| `image_url` | string | Yes | Base image URL hosted on an imgix source (e.g., your-source.imgix.net/path/to/image.jpg). The URL should not contain existing query parameters as they will be overwritten. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Draw Image Border

**Slug:** `IMGIX_BORDER`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `color` | string | Yes | Border color as a CSS keyword or hexadecimal value (3/4/6/8-digit), e.g., 'red', 'FF0000', or '80FF0000' |
| `width` | integer | Yes | Border thickness in pixels; must be a positive integer. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/pic.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bri` | number | No | Brightness adjustment in percent, between -100 (darkest) and 100 (brightest). Default is 0 (no change). |
| `source` | string | Yes | Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash. |
| `asset_path` | string | Yes | Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The identifier of the Source containing the upload session. |
| `session_id` | string | Yes | The unique identifier of the upload session to cancel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ch` | array | Yes | List of Client Hints tokens to opt into. Allowed values: 'Width', 'DPR', 'Save-Data'. Overrides 'w' and 'dpr' URL params; 'Save-Data' enforces q=45 and may change output format. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The Source identifier for the upload session. |
| `session_id` | string | Yes | The upload session identifier (UUID format) to close. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `con` | number | No | Contrast adjustment in percent, between -100 (lowest contrast) and 100 (highest contrast). Default is 0 for no change. |
| `source` | string | Yes | Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash. |
| `asset_path` | string | Yes | Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Source data to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The Source ID where the asset will be uploaded. Must be a storage-backed source (S3, GCS, or Azure). |
| `origin_path` | string | Yes | The destination path for the asset within the source, e.g., 'images/photo.jpg'. This path will be used in subsequent imgix transformations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cs` | string ("origin" | "srgb" | "adobergb1998" | "tinysrgb" | "strip") | No | Color space of the output image. Accepted values: 'origin', 'srgb', 'adobergb1998', 'tinysrgb', 'strip'. If omitted, uses 'origin'. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dl` | string | No | Desired filename for the downloaded file. When provided, the browser will prompt to save the file with this name instead of the original filename. Mutually exclusive with dl64. |
| `dl64` | string | No | Base64-encoded (URL-safe) filename for download. Use this when the filename contains special characters that need URL encoding. Mutually exclusive with dl. Example: 'bXktaW1hZ2UuanBn' is base64 for 'my-image.jpg'. |
| `path` | string | Yes | Path to the asset within the source, relative to the source root. Do not include the domain or leading 'https://'. Example: 'images/photo.jpg' or 'folder/subfolder/image.png'. |
| `source` | string | Yes | Imgix source domain or subdomain for the asset. This is typically in the format 'your-source.imgix.net' or a custom domain configured in your Imgix account. Use IMGIX_LIST_SOURCES to discover available source domains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fm` | string ("jpg" | "png") | No | Optional. Convert the image to this format before setting DPI (only 'jpg' or 'png'). |
| `dpi` | integer | Yes | Dots per inch (DPI) to embed in the image Exif header; integer ≥1. Only applies to JPEG and PNG images. |
| `source` | string | Yes | Imgix source domain without protocol (e.g., 'my-source'). Do not include 'https://' or trailing slash. |
| `asset_path` | string | Yes | Asset path on your Imgix source (e.g., 'photos/image.jpg'). Do not include leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | integer | No | Desired output height in pixels (integer ≥ 1). At least one of width or height is required.' |
| `w` | integer | No | Desired output width in pixels (integer ≥ 1). At least one of width or height is required.' |
| `dpr` | number | No | Device pixel ratio controlling image output density. Default is 1; must be ≥ 0 and ≤ 5. Requires width and/or height to take effect. |
| `source` | string | Yes | Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash.' |
| `asset_path` | string | Yes | Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash.' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | Yes | Asset path within the source (e.g., "images/photo.jpg"). Exclude leading slash. |
| `expires` | integer | Yes | Absolute UNIX timestamp (seconds since epoch) after which the URL will return 404 |
| `source_domain` | string | Yes | Imgix source domain (e.g., "my-source.imgix.net"). Exclude protocol. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IMGIX_FIT

**Slug:** `IMGIX_FIT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | string | Yes | Output height in pixels (1-8192) or ratio (0.0-1.0) of source height |
| `w` | string | Yes | Output width in pixels (1-8192) or ratio (0.0-1.0) of source width |
| `fit` | string ("clamp" | "clip" | "crop" | "facearea" | "fill" | "fillmax" | "max" | "min" | "scale") | Yes | Specifies how to fit the image within the target dimensions. One of: clamp, clip, crop, facearea, fill, fillmax, max, min, scale. |
| `facepad` | number | No | Padding around detected faces as fraction of face bounding box when fit='facearea' |
| `faceindex` | integer | No | Select which detected face to prioritize when fit='facearea' |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash) |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fm` | string ("avif" | "gif" | "jp2" | "jpg" | "json" | "jxr" | "pjpg" | "mp4" | "png" | "png8" | "png32" | "webm" | "webp" | "blurhash") | Yes | Output format to convert the asset to. Valid values: avif, gif, jp2, jpg, json, jxr, pjpg, mp4, png, png8, png32, webm, webp, blurhash. |
| `path` | string | Yes | Asset path within the source (e.g., "images/photo.jpg") |
| `source` | string | Yes | Imgix source domain (e.g., "my-source.imgix.net") |
| `lossless` | boolean | No | Only valid when fm='webp' or fm='jxr'. Set to true to request lossless WebP or JPEG XR delivery. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | string | No | Desired height in pixels (integer) or as a ratio (0.0-1.0). If omitted and 'w' is set, 'h' is auto-calculated. |
| `w` | string | No | Desired width in pixels (integer) or as a ratio (0.0-1.0). If omitted and 'h' is set, 'w' is auto-calculated. |
| `ar` | string | Yes | Target aspect ratio in 'W:H' format. Use integers or decimals, e.g., '16:9', '4:3', '1.5:1'. |
| `fit` | string ("crop" | "fill") | Yes | How the image fits the target ratio. Must be 'crop' or 'fill'. |
| `crop` | string ("top" | "bottom" | "left" | "right" | "faces" | "focalpoint" | "edges" | "entropy") | No | When 'fit=crop', controls alignment of the crop box. Defaults to center if unset. |
| `fill` | string ("solid" | "blur" | "gradient" | "gen") | No | When 'fit=fill', determines how excess space is filled. Options: 'solid', 'blur', 'gradient', 'gen'. |
| `path` | string | Yes | Path to the image on your Imgix source, e.g., 'images/photo.jpg'. Exclude leading slash. |
| `fill_color` | string | No | Color for solid fill, e.g., '#ff0000' or 'red'. Only used when 'fill=solid'. |
| `source_domain` | string | Yes | Your Imgix source domain, e.g., 'my-source.imgix.net'. Exclude protocol ('http://' or 'https://'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The unique identifier of the source to retrieve. |
| `fields_sources` | string | No | Comma-separated list of Source fields to return; use dot notation for nested fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The source identifier where the upload session exists. |
| `session_id` | string | Yes | The unique identifier for the upload session (UUID format). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | string | Yes | Height of the output image. Provide a positive integer for pixel height (1-8192), or a float >0.0 and ≤1.0 to specify a ratio of the source height. |
| `source` | string | Yes | Imgix source domain (e.g., 'my-source'). Do not include protocol or trailing slash. |
| `asset_path` | string | Yes | Path to the image on your Imgix source (e.g., 'photos/image.jpg'); omit leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `high` | number | No | Highlight tonal mapping adjustment in percent, between -100 (reduce highlights most) and 0 (no change). |
| `source` | string | Yes | Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash. |
| `asset_path` | string | Yes | Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort by. Supported fields: date_created, date_modified, file_size. Prefix with '-' for descending order (e.g., '-date_created'). |
| `source_id` | string | Yes | The unique identifier of the source to list assets from. |
| `page_limit` | integer | No | Number of items per page. Must be ≥ 1. |
| `filter_tags` | string | No | Comma-separated tag values to filter by (AND logic). |
| `page_cursor` | string | No | Cursor for pagination. Use the 'next' cursor value from a previous response to retrieve the next page. |
| `filter_colors` | string | No | Hex color code without the '#' symbol to filter by dominant color. |
| `filter_keyword` | string | No | Search keyword to filter assets across multiple fields including origin path and description. |
| `filter_categories` | string | No | Comma-separated category values to filter by (AND logic). |
| `filter_face_count` | string | No | Filter by number of faces detected. Single integer for exact match, or range format: '1:3' (1 to 3), '1:' (1 or more), ':2' (up to 2). |
| `filter_has_frames` | boolean | No | Filter for animation assets (videos or GIFs). Set to true to return only animations. |
| `filter_media_kind` | string ("IMAGE" | "ANIMATION" | "DOCUMENT" | "VECTOR") | No | Filter by asset type. |
| `filter_origin_path` | string | No | Filter by asset path relative to source prefix. |
| `filter_warning_racy` | string | No | Filter by racy content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'. |
| `filter_warning_adult` | string | No | Filter by adult content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'. |
| `filter_warning_spoof` | string | No | Filter by spoof content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'. |
| `filter_warning_medical` | string | No | Filter by medical content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'. |
| `filter_warning_violence` | string | No | Filter by violence content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort by field. Supported fields: period_end, period_start, report_key, report_type. Prefix with '-' for descending order. |
| `fields_reports` | string | No | Comma-separated list of report fields to return (sparse fieldsets). Use dot notation for nested fields. |
| `filter_completed` | boolean | No | Filter by completion status. True returns only completed reports, False returns only incomplete reports. |
| `filter_report_type` | string ("cdn_logs" | "image_analytics" | "mild_errors" | "source_analytics") | No | Filter by report type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Comma-separated fields to sort by; prepend '-' for descending. Supported: date_deployed, enabled, name. |
| `page_size` | integer | No | Page size; must be ≥ 1. |
| `filter_name` | string | No | Filter by Source name (ANDed with other filters). |
| `page_number` | integer | No | Zero-indexed page number. |
| `fields_sources` | string | No | Comma-delimited list of Source fields to return; use dot notation for nested fields. |
| `filter_enabled` | boolean | No | Filter by enabled status. |
| `filter_deployment_type` | string ("azure" | "gcs" | "s3" | "webfolder" | "webproxy" | "s3_compatible") | No | Filter by deployment type. |
| `filter_deployment_region` | string | No | S3-Compatible region filter. |
| `filter_deployment_s3_bucket` | string | No | S3 bucket name filter. |
| `filter_deployment_gcs_bucket` | string | No | GCS bucket name filter. |
| `filter_deployment_bucket_name` | string | No | S3-Compatible bucket name filter. |
| `filter_deployment_azure_bucket` | string | No | Azure container name filter. |
| `filter_deployment_custom_domains` | string | No | Custom domains filter. |
| `filter_deployment_imgix_subdomains` | string | No | Imgix subdomains filter. |
| `filter_deployment_storage_provider` | string | No | S3-Compatible storage provider filter. |
| `filter_deployment_webfolder_base_url` | string | No | Web Folder base URL filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mark_base` | string | Yes | Fully qualified base URL to prepend to the watermark image path. Must include scheme, e.g., 'https://cdn.example.com' |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mark_fit` | string ("clip" | "crop" | "max" | "scale") | No | Controls how the watermark fits within the specified dimensions. Allowed values: - clip: preserve aspect ratio within bounds (default); - crop: fill bounds exactly (requires mark-w and mark-h); - max: fit within bounds without upscaling; - scale: force exact target dimensions. |
| `image_url` | string | Yes | The Imgix URL to which the watermark fit mode will be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mark` | string | Yes | Overlay source URL for the watermark image or text overlay. |
| `mark-h` | string | Yes | Watermark height. Provide a positive integer >1 and <=2000 to specify pixel height, or a float between 0.0 and 1.0 inclusive to specify a ratio of the watermark source height. |
| `image_url` | string | Yes | Existing Imgix URL to which the watermark height parameter will be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Full URL of the source image (including any existing query parameters). |
| `mark-pad` | integer | No | Number of pixels of padding between watermark and image edge; also between tiled watermark images. Must be an integer ≥ 0. Defaults to 5 if omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mark_w` | string | Yes | Watermark width. Specify an integer ≥1 to set an absolute pixel width, or a float >0 and ≤1 to set a ratio of the watermark source's width. |
| `image_url` | string | Yes | The Imgix URL to which the watermark width will be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IMGIX_MASK

**Slug:** `IMGIX_MASK`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mask` | string | No | Mask type: 'corners', 'ellipse', or an image URL; URL or comma-separated values must be URL-encoded |
| `mask64` | string | No | Base64-encoded mask; use when encoding URLs or comma-separated values |
| `mask-bg` | string | No | Background color for masked areas; accepts CSS keywords or hex (e.g., 'FF0000' or 'red') |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash) |
| `corner-radius` | string | No | Corner radius in pixels; integer or comma-separated list of up to 4 values, used when mask='corners' |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `max-h` | integer | Yes | Maximum height in pixels for the output image. The image will be cropped (with fit=crop) to ensure its height does not exceed this value. Useful for vertically-scrolling feeds to prevent excessively tall images. |
| `image_path` | string | Yes | Path to the image file within the source (e.g., 'photos/hero.jpg'). Leading slashes are automatically handled. |
| `source_domain` | string | Yes | Imgix source domain hostname without protocol (e.g., 'my-source.imgix.net' or 'assets.imgix.net'). Do NOT include 'https://'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `max_w` | integer | Yes | Maximum allowed output width in pixels (works only with fit=crop). Must be between 1 and 8192. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash) |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `colors` | integer | No | Number of colors to include in the palette (0-16). Default 6. |
| `prefix` | string | No | CSS class prefix when palette='css'. Ignored for JSON. |
| `palette` | string ("css" | "json") | No | Output format: 'json' for structured data, 'css' for stylesheet. |
| `signature` | string | No | URL signature (s=...) if secure URLs are enabled. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'. Omit leading slash. |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net'. Do not include protocol. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `colors` | integer | No | Number of colors to include in the palette; default is 6; valid range 0–16. |
| `prefix` | string | No | CSS class name prefix to use instead of the default 'image'; ignored when palette='json'. |
| `palette` | string ("css" | "json") | No | Output format: 'css' to receive a CSS stylesheet, 'json' for JSON palette output; prefix is only applied when 'css'. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'examples/pione.jpg'. May include or omit leading slash. |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'assets.imgix.net'. Do not include protocol. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The full imgix URL of the asset to purge from cache. Must be a valid imgix URL including the subdomain (e.g., https://your-source.imgix.net/path/to/image.jpg). After purge, the next request will fetch a fresh version from origin. |
| `source_id` | string | No | Optional Source ID to scope the purge operation to a specific source. |
| `sub_image` | boolean | No | If true, purges only sub-images (specific variants/transformations) of the asset. If false or omitted, purges the entire asset including all variants. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Output Quality

**Slug:** `IMGIX_Q`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | integer | No | Output quality for lossy formats (jpg, pjpg, webp, avif, jxr). Valid range 0-100; default 75. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash) |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h` | string | Yes | Height of the rectangle: integer pixels, fraction (0.0-1.0), or 'full' for full image height. |
| `w` | string | Yes | Width of the rectangle: integer pixels, fraction (0.0-1.0), or 'full' for full image width. |
| `x` | string | Yes | Horizontal offset for the rectangle origin: integer pixels, fraction (0.0-1.0), or one of 'left','center','right'. |
| `y` | string | Yes | Vertical offset for the rectangle origin: integer pixels, fraction (0.0-1.0), or one of 'top','middle','bottom'. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash. |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol ('http://' or 'https://'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rot` | integer | No | Degrees to rotate the image counter-clockwise. Must be between 0 and 359. |
| `path` | string | Yes | Asset path within the source (e.g., "images/photo.jpg"). Exclude leading slash. |
| `source` | string | Yes | Imgix source domain (e.g., "my-source.imgix.net"). Exclude protocol prefix. |
| `rot-type` | string ("pivot" | "straighten") | No | When set, controls rotation mode: 'pivot' shows full image; 'straighten' zooms and crops. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rot-type` | string ("pivot" | "straighten") | Yes | Type of rotation behavior: `pivot` displays the entire image without cropping; `straighten` zooms in and crops to straighten an image. |
| `image_url` | string | Yes | Full Imgix image URL to which the `rot-type` parameter will be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `txt` | string | No | Text string to render (UTF-8 supported, including emoji) |
| `txt64` | string | No | URL-safe Base64 encoded text string. Use this instead of 'txt' when your text contains special characters that might break URLs. Omit the '=' padding from the Base64 value. |
| `image_url` | string | Yes | URL of the source image to overlay text onto |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vertical` | string ("top" | "middle" | "bottom") | No | Vertical alignment of the text overlay: 'top', 'middle', or 'bottom' |
| `horizontal` | string ("left" | "center" | "right") | No | Horizontal alignment of the text overlay: 'left', 'center', or 'right' |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_url` | string | Yes | Source Imgix URL or source domain with path |
| `txt_color` | string | No | CSS color keyword or 3-/4-/6-/8-digit hex (RGB/ARGB/RRGGBB/AARRGGBB). 4-/8-digit hex supports alpha transparency. Default is opaque black '000'. |
| `txt_color64` | string | No | URL-safe Base64-encoded color value. Use when color contains special characters. Mutually exclusive with txt_color. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `font` | string | Yes | Defines the typeface and style for overlay text. Accepts CSS categories: serif, sans-serif, monospace, cursive, fantasy, or explicit font names. To add bold and/or italic, append comma-separated flags (e.g., 'sans-serif,bold,italic'). |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash) |
| `use_base64` | boolean | No | If true, the font value will be URL-safe Base64 encoded and sent in the 'txt-font64' parameter instead of 'txt-font'. |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Text Outline Width

**Slug:** `IMGIX_TXT_LINE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `txt-line` | integer | Yes | Width of the outline to draw around overlay text in pixels. 0 draws no outline (default). Outline is drawn inside text edges. |
| `image_url` | string | Yes | Existing Imgix URL to which the text outline width parameter will be applied. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `color` | string | Yes | Color for the text outline. Accepts CSS color keywords (e.g., 'red', 'blue', 'black') or hex codes in these formats: 3-digit RGB (fff), 4-digit ARGB (a0f0), 6-digit RRGGBB (ff0000), or 8-digit AARRGGBB (80ff0000 for semi-transparent red). |
| `encode` | boolean | No | If true, Base64-encode the color value and use 'txt-line-color64' parameter. Use this when the color value contains special characters that need URL encoding. |
| `image_url` | string | Yes | Imgix image URL with text overlay parameters. Should include 'txt' (or 'txt64') for text content and 'txt-line' for outline width. The outline color set by this action will only be visible when txt-line > 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `strength` | integer | No | Strength of text shadow (0-10). 0 means no shadow, 10 is maximum shadow intensity. Note: This parameter only has a visible effect when used in combination with text overlay parameters (txt). Use this to add depth to text overlays on images. |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'examples/photo.jpg'. Leading slash is optional and will be stripped. |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'assets.imgix.net'. Must not include protocol (http:// or https://). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | integer | No | Font size of the overlay text in pixels; must be ≥ 1 |
| `image_path` | string | Yes | Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash |
| `source_domain` | string | Yes | Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | JSON:API data object containing the source updates. |
| `source_id` | string | Yes | The unique identifier of the source to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |