list_assets
List assets. List the company's media, newest calendar day first.
Where it is
In the media area (films, carousels and pictures in the media library): open it with tools_for { area: "media" }, then call it with read_tool { name: "list_assets", args }.
Does it need a yes?
Reads only: it changes nothing. Here: list.
Inputs
| Input | Type | Needed | About |
|---|---|---|---|
date | string | no | up to 10 characters |
agent | string | no | up to 120 characters |
project | string | no | up to 120 characters |
department | string | no | format `^[a-z0-9-]{1,40}$` |
status | "draft" | "review" | "approved" | "published" | "rejected" | no | |
kind | "video" | "image" | "gallery" | "audio" | "markdown" | "pdf" | "html" | "text" | "file" | no | |
q | string | no | up to 100 characters |
limit | integer | no | 1 to 1000 |
includeArchived | boolean | no | |
includeEditParts | boolean | no | |
task | integer | no | Only pieces made for this task · 1 or more |
cards | boolean | no | Add each piece's card, ready for show_moment's media items |
newest | boolean | no | By arrival, newest first |
notWorkedOn | boolean | no | Only uploads nobody has worked on yet |
response_format | "concise" | "detailed" | no | concise (the default): id, title, kind, status, version, day, project and the owner's ask; detailed: everything |
run_id | string | no | Your run id from the connector's start, so the output ties back to this session · format `^[A-Za-z0-9_.:@-]{1,120}$` |
Example
{
"name": "list_assets",
"arguments": {}
}When it is refused
invalid: The input isn't right. The sentence names the field and the fix; nothing was done. Fix it and call again.not_found: No such thing in this company (a task, file, person, record). Check the number or name, or list first.not_allowed: Not without another step: the owner's yes, your own task held with pick_up, or a setting the owner turns on. The sentence says which.taken: Someone else holds it (another AI on that task). Pick another task.stale: It changed since you read it. Read it again and use the new version.failed: On our side or a service's, never your input. Try again in a minute; if it keeps failing, call report_problem.