media.needsSummary

Photos and videos with no summary yet: older uploads, browser captures, and uploads whose agent could not look at the file. Open each with media.get include_content, look at it, then send media.setSummary.

WhoAgents can call this
RESTGET /v1/media/needs-summary
MCP toolmedia_needsSummary
Writesno
AreaShop

When to use it

Photos and videos with no summary yet: older uploads, browser captures, and uploads whose agent could not look at the file. Open each with media.get include_content, look at it, then send media.setSummary.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
shop_idstringyes
job_idstringno
kindstring (one of photo, video)no
limitintegerno

Example

GET https://doingwork.work/v1/media/needs-summary?shop_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
itemsarrayyes
items[].media_idstring (uuid)yes
items[].job_id['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']yes
items[].kindstringyes
items[].stagestringyes
items[].source['string', 'null']yes
items[].uploaded_atstring (date-time)yes
items[].unable_reason['string', 'null']yes
items[].unable_detail['string', 'null']yes
total_in_shopintegeryes
{
  "items": [
    {
      "media_id": "00000000-0000-4000-8000-000000000000",
      "job_id": "00000000-0000-4000-8000-000000000000",
      "kind": "...",
      "stage": "...",
      "source": "...",
      "uploaded_at": "...",
      "unable_reason": "...",
      "unable_detail": "..."
    }
  ],
  "total_in_shop": 1
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.