Get an asset
Returns the asset with description, category, and its CDN delivery shape: for transformable images url is the optimized 1920px default and originalUrl the original bytes; both never expire. MCP clients that render images also receive the image.
Authorizations
Cactal API key. Create one in the dashboard or via POST /apiKeys. The plaintext key is shown once at creation.
Path Parameters
1Response
The asset with its public CDN delivery URLs.
Unique asset id. Pass it to websiteAssets.get and websiteAssets.delete.
Asset kind. Each kind has its own MIME allowlist and size limit.
image, file Original filename supplied at upload (1–255 characters).
MIME type stored for the asset after upload normalization.
One-line description supplied at upload, edited later, or generated for dashboard uploads. null when absent.
Image category: logo, icon, photo, illustration, screenshot, graphic, background, or other. null for files and unclassified images.
logo, icon, photo, illustration, screenshot, graphic, background, other Exact file size in bytes.
Intrinsic pixel width, recorded at finalize for images. null for non-images and formats whose dimensions cannot be read.
Intrinsic pixel height; see width.
Up to 8 representative colors sorted by share. null for files and for images that could not be analyzed.
8Fraction of the backdrop that shows through, weighting each pixel by its transparency: 0 for an opaque image, roughly the background area for a cutout, 0.5 for a uniform 50% overlay. null when unknown.
0 <= x <= 1Fraction of pixels with partial alpha (soft shadows, glows, fades, glass), excluding fully transparent and fully opaque pixels. null when unknown.
0 <= x <= 1For a background-removed image, the id of the asset it was derived from.
Optimized public CDN URL for display. Transformable images use the 1920px default variant; other assets use originalUrl.
Stable public CDN URL for the original bytes. It never expires.
For SVG images, the stable public CDN URL of a rasterized PNG preview (longest edge 1024px) that image models, MCP previews, and favicon fallbacks use. null for other assets and for SVGs that could not be rendered.
Ready-to-use responsive image srcset. null when image transformation is unavailable.
Optimized image URLs keyed by pixel width. Empty when image transformation is unavailable.
When the upload was started.
pending until websiteAssets.finalize confirms the upload; ready once the asset is servable.
pending, ready