get_source
Get Source
Retrieve full details of a specific Imgix source by its ID. Returns the source's configuration including deployment settings, cache behavior, security settings, custom domains, and current deployment status.
get_source
Retrieve full details of a specific Imgix source by its ID. Returns the source's configuration including deployment settings, cache behavior, security settings, custom domains, and current deployment status.
generate_signed_url
Generate a signed/secure Imgix URL for an image. Signed URLs prevent unauthorized modifications to URL parameters and can include an expiration timestamp. Requires the source's secure URL token (available from the source configuration). Useful for protecting premium content or time-limited access.
purge_cache
Purge a cached asset from the Imgix CDN. When an asset is updated at the origin, use this to force Imgix to fetch the newest version. Purging an asset URL automatically removes all derivative (transformed) versions. For watermark or blend sub-images, enable the subImage flag to cascade purges to all parent images.
update_source
Update configuration for an existing Imgix source. You can change the source name, enable/disable it, modify cache TTL behavior, update default rendering parameters, configure custom domains, enable secure URL signing, or update deployment settings. Changes to deployment settings will automatically trigger redeployment.
get_reports
Retrieve analytics reports from Imgix. Reports are updated daily and retained for 90 days. Available report types include **image_analytics** (per-image metrics), **source_analytics** (per-source metrics), **cdn_logs** (CDN request logs), and **mild_errors** (4xx error data). You can list reports with filters or fetch a specific report by ID.
create_source
Create and deploy a new Imgix source. A source defines the origin storage backend from which Imgix fetches images. Supports Amazon S3, Google Cloud Storage, Microsoft Azure, Web Folder, Web Proxy, and S3-compatible storage (DigitalOcean, Cloudflare R2, Wasabi). The source will be automatically deployed after creation.
list_assets
Browse and search assets within an Imgix source. Supports filtering by keyword, path, media type, categories, and tags. Returns asset metadata including dimensions, file size, and custom fields. Use cursor-based pagination for large result sets.
update_asset
Update metadata for an asset within an Imgix source. You can modify the asset's name, description, categories, and custom fields. Use this to organize and annotate your image library.
build_render_url
Build an Imgix rendering URL with transformation parameters. Constructs a URL that applies real-time image transformations including resizing, cropping, format conversion, quality adjustment, watermarks, text overlays, blur, and more. The resulting URL can be used directly in HTML or applications for on-the-fly image processing.
list_sources
List all Imgix sources in your account. Sources define the origin storage backends (S3, GCS, Azure, Web Folder, Web Proxy, or S3-compatible) from which Imgix fetches and serves images. Use filtering to narrow results by name, enabled status, or deployment type.
get_asset
Retrieve detailed metadata for a specific asset within an Imgix source. Returns comprehensive information including dimensions, file size, detected colors, face count, content warnings, categories, tags, and custom fields.
refresh_asset
Refresh an asset from its origin storage, forcing Imgix to re-fetch and reprocess the latest version. If the asset's ETag has changed, the cache is automatically purged. Use this when the origin file has been updated and you want Imgix to pick up the changes.
Process, transform, and optimize images and videos in real time via URL-based parameters. Manage image sources backed by S3, GCS, Azure, and other storage providers. Upload, browse, search, and edit assets and their metadata. Apply transformations including resize, crop, format conversion, compression, watermarks, text overlays, background removal, and AI-powered background replacement. Generate video thumbnails, convert video to GIF, and optimize video playback. Purge cached assets from the CDN. Generate signed/secure URLs with expiration. Retrieve image and source analytics reports.
Common questions about connecting Imgix to AI agents with Metorial.