List image assets

Search Documentation

Search across all developer documentation

assets

List image assets

GET /v1/assets
Auth required api.assets.view

Returns the org's image asset library — the images discovered in a connected git repo and promoted on deploy — ordered by source path. url is the public CDN URL, or empty until an Edge stack is provisioned. Read-only: assets are managed via git, not this API.

Query parameters

limit integer optional

Page size (1–200). Default 50.

cursor string optional

Opaque cursor returned from the previous page.

tag array optional

Filter to entities carrying a tag with this full path name (repeatable; union/OR across values — the Gmail default). Pass untagged=true instead to return only entities with no tags. Applied before pagination.

Responses

200 Cursor-paginated list of image assets application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
422 Query parameter or path value failed validation 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