stensul-list-gallery-images
Browses the account's approved image gallery. Use it before asking the user for a file.
name is a substring match on the image name, not a search of what the picture shows. Browse without it when unsure.
Inputs
- namestringoptional
Part of the image name, case-insensitive.
- page_numberinteger ≥ 1optional
Page number (default 1).
- page_sizeinteger 1–30optional
Results per page (max 30, default 10).
- sort"createdAt" | "-createdAt" | "updatedAt" | "-updatedAt"optional
Default
-createdAt(newest first).
Errors people hit
| What you see | Fix |
|---|---|
| 401 Authentication expired or missing The session's authorization expired. | Sign in again when the host prompts. On a 401 or 403, the server's instructions tell the model to re-check sign-in first. |
| 403 Insufficient OAuth scope (403): The token lacks the required scope The API connection doesn't have the scope this tool needs. | An admin adds the scope to the API connection. Then sign in again: adding a scope revokes existing tokens. |
| 403 API error (403): Action is unauthorized. The signed-in user's role lacks the permission, for example edit_campaign. | Grant the permission to the user's role in Admin > Users & Roles. It works for other users on the same connection. |
All errors: Errors and troubleshooting.
{
"name": "autumn",
"page_size": 10
}{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "stensul-list-gallery-images",
"arguments": {
"name": "autumn",
"page_size": 10
}
}
}Gallery images with their url, which you can pass as imageContent.source_url in stensul-build-email.
Described from the tool's definition. Captured responses from a Stensul-internal tenant will replace this.
Example values use invented brands and ids. Tool list captured 2026-09-28.