imgix is a real-time image processing and delivery service that enables developers to optimize, transform, and deliver images efficiently.
imgix is a real-time image processing and delivery service that enables developers to optimize, transform, and deliver images efficiently. On Nagent, Imgix is exposed as a fully-configurable images & design integration that any agent can call — 53 actions, and API key authentication. No code is required to wire Imgix into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Imgix to automate the kinds of tasks images & design teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Imgix into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Imgix, with input parameters and output schema. Drop these into any step of an agent built in Helix.
IMGIX_ADD_ASSET_FROM_ORIGINTool 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
The unique identifier of the source where the asset will be added.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_AUTOApply 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
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 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'.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BLENDTool 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
URL-encoded overlay URL (image or text), absolute or relative.
URL-safe Base64-encoded overlay URL (image or text).
Overlay height in pixels (>1) or ratio of base height (0.0-1.0)
Overlay width in pixels (>1) or ratio of base width (0.0-1.0)
Horizontal offset in pixels from the left edge
Vertical offset in pixels from the top edge
How the overlay is fit into its blend_w/blend_h box
Padding in pixels around the overlay when alignment is used
When blend_fit='crop', crop focus: top, bottom, left, right, faces; CSV
How the overlay interacts with the base image.
If 'inherit', overlay inherits base image sizing/cropping
Overlay alignment: top, middle, bottom, left, center, right or 'horizontal,vertical'.
Overlay transparency (0 transparent, 100 opaque).
Solid color overlay; accepts keywords or hex strings (3/4/6/8-digit AARRGGBB).
The URL of the base image to which the overlay will be applied
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BLEND_ALIGNTool 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
Vertical alignment of the overlay relative to the base image
The Imgix image URL to which the blend-align parameter will be applied
Horizontal alignment of the overlay relative to the base image
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BLEND_COLORTool 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
Source image URL
How the color blends with the image; default is 'overlay'
Overlay transparency from 0 (transparent) to 100 (opaque)
Color keyword or 3-/4-/6-/8-digit hex; for hex, prefix with '#' optional; 4/8-digit include alpha channel
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BLEND_XPosition 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
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.
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.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BORDERTool to draw a border around an image. Use when you need to overlay a border without resizing.
Input parameters
Border color as a CSS keyword or hexadecimal value (3/4/6/8-digit), e.g., 'red', 'FF0000', or '80FF0000'
Border thickness in pixels; must be a positive integer.
Path to the image within the source, e.g., 'images/pic.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_BRITool 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
Brightness adjustment in percent, between -100 (darkest) and 100 (brightest). Default is 0 (no change).
Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash.
Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CANCEL_UPLOAD_SESSIONTool 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
The identifier of the Source containing the upload session.
The unique identifier of the upload session to cancel.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CHTool to opt in to Client Hints. Use when you want Imgix URLs to adapt based on browser headers (Width, DPR, Save-Data).
Input parameters
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.
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CLOSE_UPLOAD_SESSIONTool 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
The Source identifier for the upload session.
The upload session identifier (UUID format) to close.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CONTool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).
Input parameters
Contrast adjustment in percent, between -100 (lowest contrast) and 100 (highest contrast). Default is 0 for no change.
Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash.
Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CREATE_IMGIX_SOURCETool 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
Source data to create.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CREATE_UPLOAD_SESSIONTool 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
The Source ID where the asset will be uploaded. Must be a storage-backed source (S3, GCS, or Azure).
The destination path for the asset within the source, e.g., 'images/photo.jpg'. This path will be used in subsequent imgix transformations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_CSTool 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
Color space of the output image. Accepted values: 'origin', 'srgb', 'adobergb1998', 'tinysrgb', 'strip'. If omitted, uses 'origin'.
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_DLDownload 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
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.
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 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'.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_DPITool 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
Optional. Convert the image to this format before setting DPI (only 'jpg' or 'png').
Dots per inch (DPI) to embed in the image Exif header; integer ≥1. Only applies to JPEG and PNG images.
Imgix source domain without protocol (e.g., 'my-source'). Do not include 'https://' or trailing slash.
Asset path on your Imgix source (e.g., 'photos/image.jpg'). Do not include leading slash.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_DPRTool 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
Desired output height in pixels (integer ≥ 1). At least one of width or height is required.'
Desired output width in pixels (integer ≥ 1). At least one of width or height is required.'
Device pixel ratio controlling image output density. Default is 1; must be ≥ 0 and ≤ 5. Requires width and/or height to take effect.
Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash.'
Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash.'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_EXPIRESTool 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
Asset path within the source (e.g., "images/photo.jpg"). Exclude leading slash.
Absolute UNIX timestamp (seconds since epoch) after which the URL will return 404
Imgix source domain (e.g., "my-source.imgix.net"). Exclude protocol.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_FITTool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.
Input parameters
Output height in pixels (1-8192) or ratio (0.0-1.0) of source height
Output width in pixels (1-8192) or ratio (0.0-1.0) of source width
Specifies how to fit the image within the target dimensions. One of: clamp, clip, crop, facearea, fill, fillmax, max, min, scale.
Padding around detected faces as fraction of face bounding box when fit='facearea'
Select which detected face to prioritize when fit='facearea'
Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash)
Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_FMTool to choose output file format for the rendered asset. Use after specifying the asset path when you need to convert its format.
Input parameters
Output format to convert the asset to. Valid values: avif, gif, jp2, jpg, json, jxr, pjpg, mp4, png, png8, png32, webm, webp, blurhash.
Asset path within the source (e.g., "images/photo.jpg")
Imgix source domain (e.g., "my-source.imgix.net")
Only valid when fm='webp' or fm='jxr'. Set to true to request lossless WebP or JPEG XR delivery.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_FORCE_ASPECT_RATIOTool 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
Desired height in pixels (integer) or as a ratio (0.0-1.0). If omitted and 'w' is set, 'h' is auto-calculated.
Desired width in pixels (integer) or as a ratio (0.0-1.0). If omitted and 'h' is set, 'w' is auto-calculated.
Target aspect ratio in 'W:H' format. Use integers or decimals, e.g., '16:9', '4:3', '1.5:1'.
How the image fits the target ratio. Must be 'crop' or 'fill'.
When 'fit=crop', controls alignment of the crop box. Defaults to center if unset.
When 'fit=fill', determines how excess space is filled. Options: 'solid', 'blur', 'gradient', 'gen'.
Path to the image on your Imgix source, e.g., 'images/photo.jpg'. Exclude leading slash.
Color for solid fill, e.g., '#ff0000' or 'red'. Only used when 'fill=solid'.
Your Imgix source domain, e.g., 'my-source.imgix.net'. Exclude protocol ('http://' or 'https://').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_GET_SOURCETool to retrieve details for a single imgix Source by its ID. Returns the source configuration including deployment status, type, and settings.
Input parameters
The unique identifier of the source to retrieve.
Comma-separated list of Source fields to return; use dot notation for nested fields.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_GET_UPLOAD_SESSION_STATUSTool 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
The source identifier where the upload session exists.
The unique identifier for the upload session (UUID format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_HTool 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
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.
Imgix source domain (e.g., 'my-source'). Do not include protocol or trailing slash.
Path to the image on your Imgix source (e.g., 'photos/image.jpg'); omit leading slash.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_HIGHTool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.
Input parameters
Highlight tonal mapping adjustment in percent, between -100 (reduce highlights most) and 0 (no change).
Imgix source domain (e.g., 'my-source'). Do not include 'https://' or trailing slash.
Path to the image asset on your Imgix source (e.g., 'photos/image.jpg'). No leading slash.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_LIST_ASSETSTool 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
Field to sort by. Supported fields: date_created, date_modified, file_size. Prefix with '-' for descending order (e.g., '-date_created').
The unique identifier of the source to list assets from.
Number of items per page. Must be ≥ 1.
Comma-separated tag values to filter by (AND logic).
Cursor for pagination. Use the 'next' cursor value from a previous response to retrieve the next page.
Hex color code without the '#' symbol to filter by dominant color.
Search keyword to filter assets across multiple fields including origin path and description.
Comma-separated category values to filter by (AND logic).
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 for animation assets (videos or GIFs). Set to true to return only animations.
Filter by asset type.
Filter by asset path relative to source prefix.
Filter by racy content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'.
Filter by adult content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'.
Filter by spoof content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'.
Filter by medical content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'.
Filter by violence content warning level (0-5 scale). Single integer or range format: '1:3', '1:', ':2'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_LIST_REPORTSTool 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
Sort by field. Supported fields: period_end, period_start, report_key, report_type. Prefix with '-' for descending order.
Comma-separated list of report fields to return (sparse fieldsets). Use dot notation for nested fields.
Filter by completion status. True returns only completed reports, False returns only incomplete reports.
Filter by report type.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_LIST_SOURCESTool to list all Sources for an account. Use when you need to retrieve and paginate through sources with optional sorting and filtering.
Input parameters
Comma-separated fields to sort by; prepend '-' for descending. Supported: date_deployed, enabled, name.
Page size; must be ≥ 1.
Filter by Source name (ANDed with other filters).
Zero-indexed page number.
Comma-delimited list of Source fields to return; use dot notation for nested fields.
Filter by enabled status.
Filter by deployment type.
S3-Compatible region filter.
S3 bucket name filter.
GCS bucket name filter.
S3-Compatible bucket name filter.
Azure container name filter.
Custom domains filter.
Imgix subdomains filter.
S3-Compatible storage provider filter.
Web Folder base URL filter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MARK_BASETool 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
Fully qualified base URL to prepend to the watermark image path. Must include scheme, e.g., 'https://cdn.example.com'
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MARK_FITTool 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
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.
The Imgix URL to which the watermark fit mode will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MARK_HTool 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
Overlay source URL for the watermark image or text overlay.
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.
Existing Imgix URL to which the watermark height parameter will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MARK_PADTool 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
Full URL of the source image (including any existing query parameters).
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MARK_WTool 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
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.
The Imgix URL to which the watermark width will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MASKTool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.
Input parameters
Mask type: 'corners', 'ellipse', or an image URL; URL or comma-separated values must be URL-encoded
Base64-encoded mask; use when encoding URLs or comma-separated values
Background color for masked areas; accepts CSS keywords or hex (e.g., 'FF0000' or 'red')
Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash)
Corner radius in pixels; integer or comma-separated list of up to 4 values, used when mask='corners'
Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MAX_HConstrain 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
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.
Path to the image file within the source (e.g., 'photos/hero.jpg'). Leading slashes are automatically handled.
Imgix source domain hostname without protocol (e.g., 'my-source.imgix.net' or 'assets.imgix.net'). Do NOT include 'https://'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_MAX_WTool 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
Maximum allowed output width in pixels (works only with fit=crop). Must be between 1 and 8192.
Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash)
Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_PALETTETool 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
Number of colors to include in the palette (0-16). Default 6.
CSS class prefix when palette='css'. Ignored for JSON.
Output format: 'json' for structured data, 'css' for stylesheet.
URL signature (s=...) if secure URLs are enabled.
Path to the image within the source, e.g., 'images/photo.jpg'. Omit leading slash.
Imgix source domain (hostname), e.g., 'example-source.imgix.net'. Do not include protocol.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_PREFIXTool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.
Input parameters
Number of colors to include in the palette; default is 6; valid range 0–16.
CSS class name prefix to use instead of the default 'image'; ignored when palette='json'.
Output format: 'css' to receive a CSS stylesheet, 'json' for JSON palette output; prefix is only applied when 'css'.
Path to the image within the source, e.g., 'examples/pione.jpg'. May include or omit leading slash.
Imgix source domain (hostname), e.g., 'assets.imgix.net'. Do not include protocol.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_PURGE_IMGIX_ASSETTool 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
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.
Optional Source ID to scope the purge operation to a specific source.
If true, purges only sub-images (specific variants/transformations) of the asset. If false or omitted, purges the entire asset including all variants.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_QTool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.
Input parameters
Output quality for lossy formats (jpg, pjpg, webp, avif, jxr). Valid range 0-100; default 75.
Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash)
Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_RECTTool 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
Height of the rectangle: integer pixels, fraction (0.0-1.0), or 'full' for full image height.
Width of the rectangle: integer pixels, fraction (0.0-1.0), or 'full' for full image width.
Horizontal offset for the rectangle origin: integer pixels, fraction (0.0-1.0), or one of 'left','center','right'.
Vertical offset for the rectangle origin: integer pixels, fraction (0.0-1.0), or one of 'top','middle','bottom'.
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash.
Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol ('http://' or 'https://').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_ROTTool to rotate an image on Imgix. Use when you need to apply a counter-clockwise rotation (0–359°) with optional mode control.
Input parameters
Degrees to rotate the image counter-clockwise. Must be between 0 and 359.
Asset path within the source (e.g., "images/photo.jpg"). Exclude leading slash.
Imgix source domain (e.g., "my-source.imgix.net"). Exclude protocol prefix.
When set, controls rotation mode: 'pivot' shows full image; 'straighten' zooms and crops.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_ROT_TYPETool 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
Type of rotation behavior: `pivot` displays the entire image without cropping; `straighten` zooms in and crops to straighten an image.
Full Imgix image URL to which the `rot-type` parameter will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXTTool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.
Input parameters
Text string to render (UTF-8 supported, including emoji)
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.
URL of the source image to overlay text onto
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_ALIGNTool 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
Vertical alignment of the text overlay: 'top', 'middle', or 'bottom'
Horizontal alignment of the text overlay: 'left', 'center', or 'right'
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_COLORTool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.
Input parameters
Source Imgix URL or source domain with path
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'.
URL-safe Base64-encoded color value. Use when color contains special characters. Mutually exclusive with txt_color.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_FONTTool 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
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').
Path to the image within the source, e.g., 'images/photo.jpg' (omit leading slash)
If true, the font value will be URL-safe Base64 encoded and sent in the 'txt-font64' parameter instead of 'txt-font'.
Imgix source domain (hostname), e.g., 'example-source.imgix.net' (exclude protocol)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_LINETool to set outline width around overlay text. Use when styling text overlays on images.
Input parameters
Width of the outline to draw around overlay text in pixels. 0 draws no outline (default). Outline is drawn inside text edges.
Existing Imgix URL to which the text outline width parameter will be applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_LINE_COLORApply 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
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).
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.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_SHADSet 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
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.
Path to the image within the source, e.g., 'examples/photo.jpg'. Leading slash is optional and will be stripped.
Imgix source domain (hostname), e.g., 'assets.imgix.net'. Must not include protocol (http:// or https://).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_TXT_SIZETool 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
Font size of the overlay text in pixels; must be ≥ 1
Path to the image within the source, e.g., 'images/photo.jpg'; omit leading slash
Imgix source domain (hostname), e.g., 'example-source.imgix.net'; exclude protocol
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
IMGIX_UPDATE_SOURCETool 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
JSON:API data object containing the source updates.
The unique identifier of the source to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 72 agents privately built on Nagent that already use Imgix.
Build on Nagent
Connect Imgix to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Imgix, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Imgix is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Imgix is connected, you configure its 53 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Imgix steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Imgix event fires, the agent kicks off automatically.
Every Imgix action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Imgix ships with 53 pre-built images & design actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Imgix together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Imgix-based workflows tailored to your business.