asset_list
List the source media (images and video) your organization owns, each with where it has been registered.
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
The active organization is taken from your token.
| Argument | Type | Description |
|---|---|---|
limit |
number |
The greatest number of Assets in the answer, from 1 to 500. The default is 100. |
cursor |
string |
The nextCursor of the previous answer. Omit it to get the first page. |
Output
{ assets: [...], nextCursor? }. When nextCursor is present, more Assets exist: call asset_list again with cursor set to that value. Each Asset row is shaped like:
| Field | Type | Description |
|---|---|---|
id |
ast_* |
The Asset id. |
name |
string | null |
User-chosen name; null until renamed, falling back to filename. |
filename |
string |
Original upload filename — never changes, the fallback for name. |
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
invalid_cursor— thecursoris not anextCursorof this tool. Send it with no change, or omit it.401or403— see Errors, which every tool shares. This one needsasset:read.