Get one image asset by id

Search Documentation

Search across all developer documentation

assets

Get one image asset by id

GET /v1/assets/{id}
Auth required api.assets.view

Returns one image asset by id, or 404 not_found when the id is not an asset in this org.

Path parameters

id string<uuid> required

Resource UUID. An unparseable id reads as a clean 404 not_found.

Responses

Errors follow the RFC 7807 problem format — see the error reference.

200 The image asset application/json
id string<uuid> required
source_path string required

Repo-relative logical path of the image in the connected git repo.

url string required

Public CDN URL for the image, or "" when no Edge stack is provisioned yet.

content_hash string required

Content-addressed hash of the image bytes.

content_type string required

MIME type, e.g. image/png.

size_bytes integer<int64> required
width integer required

Pixel width, or 0 when unknown (e.g. SVG).

height integer required

Pixel height, or 0 when unknown (e.g. SVG).

last_synced_at string<date-time> optional

Time of the last git sync; omitted when never synced.

created_at string<date-time> required
tags array<object> optional

Org-side tags/folders applied to this asset (managed via the dashboard; assets are read-only but freely taggable). Filter the collection with ?tag=.

Each entry in tags:

id string<uuid> required
name string required

Full folder path (e.g. Marketing/Newsletters).

key string required

Normalized slug handle of the name.

color string optional

Chip colour token (chart-1..chart-5), or empty.

description string optional
created_at string<date-time> required
updated_at string<date-time> required
branch string required

Git branch the asset originates on (the org's default branch).

401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json