list_generated_images
List images already generated and saved for a store — newest first.
readSellerSheet
Use this to FIND an image you or the user made earlier instead of regenerating it (a regeneration is billed again and returns a different image; the library is free and returns the exact one). Also the way to answer "what images do we have for this SKU?".
Call it
In an AI client (MCP)
{
"name": "list_generated_images",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/list_generated_images \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. Required. |
parent_sku | string | narrow to one product family. |
sku | string | narrow to one SKU — matches parent OR child, so pass whichever you have. |
slot | string | narrow to one position ('s0'-'s8', 'a1'-'a5', 'p1'-'p5'). |
limit | integer | page size, 1-200 (default 50). Above 200 is REJECTED (422), not clamped — ask for 200 and page with before_id.Default: 50 |
before_id | integer | paging cursor — pass the previous response's `next_before_id`. Do NOT compute an offset: rows are keyset- paged by id, so an offset would skip or repeat images when new ones land while you page. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.images— newest first; each carries id (pass it to set_synthetic_performer), parent_sku, child_sku, slot, version, lang, cdn_url, thumbnail_url, source, created_at and synthetic_performer.data.next_before_id— pass as before_id for the next page; null on the last page — stop there.