Objects
Response shapes returned by the public API — Asset, Library, Tag, SearchHit, and related objects. Shared across REST, GraphQL, and MCP.
The objects below are the response shapes returned by the public API. REST, GraphQL, and MCP share the same wire shape for each — endpoint pages link here for the full definition.
Asset
The core media object. Returned by GET /libraries/:libraryId/assets,
GET /search/assets, the GraphQL
assets and
searchAssets queries, and the
MCP list_assets / search_assets tools.
Prop
Type
Timestamps anywhere in the response are returned as unix milliseconds
(a number).
Detecting in-flight processing
Some Asset fields populate asynchronously after upload (the upload
response carries the permanent CDN url immediately; other fields fill
in once processing completes). Check for null on thumbUrl,
blurhash, or width to detect "still processing" and re-read via
the assets endpoint.
Uploader
Attribution metadata for an uploaded asset.
Prop
Type
AssetView
Non-destructive view variant of an asset (e.g. a crop or color adjustment).
Prop
Type
Library
A collection of assets within an organization. Returned by
GET /libraries and the GraphQL
libraries query.
Prop
Type
Tag
A tag and its usage count. Returned by
GET /libraries/:libraryId/tags
and the GraphQL tags query.
Prop
Type
SearchResult
The envelope returned by search operations. Returned by
GET /search/assets, the GraphQL
searchAssets query, and the
MCP search_assets tool.
Prop
Type
SearchHit
An Asset extended with search-result metadata. Every field on
Asset is present on SearchHit; the two additional fields below are
search-specific.
Prop
Type
SearchHitHighlights
Matched-term snippets returned alongside each SearchHit. Optional. The
name snippet wraps matched terms in <mark> tags; the tags snippet
is the matched tag strings.
Prop
Type