asset_list

Lists your organization’s Assets — the source media it owns — newest first. Each row comes back with its Registrations, so one call answers both “what creative do we have?” and “where has each piece been placed?”. See Bring your own creative for how Assets and Registrations relate.

Input

None. The active organization is taken from your token.

Output

{ assets: [...] } — an array of Asset rows, each shaped like:

Field	Type	Description
id	ast_*	The Asset id.
filename	string	Original filename as uploaded.
kind	'image' | 'video'	Selects how the file is registered.
mimeType	string	e.g. image/png, video/mp4.
sizeBytes	number	Stored size.
width / height	number	Pixel dimensions (images).
durationMs	number	Length in ms (video).
status	'pending' | 'ready'	ready means finalized and usable.
registrations	Registration[]	Where the Asset is placed — see asset_get.

Assets whose bytes never arrived are excluded — a listing only shows media you can actually use.

Example

“What creative do we have on file, and where is it registered?”

Claude calls asset_list() and reads back each Asset with its kind, filename, and the advertisers it’s been registered to.

Errors

• 401 Unauthorized — the OAuth token has expired, or lacks asset:read. Re-authorize from your AI client’s settings.