Attach Image Carousel to Post
set_post_carouselAttaches 2-10 images as a swipeable carousel to a draft or scheduled post. Takes an ordered array of HTTPS image URLs (each max 10MB); order is kept as slide order and every image is rehosted to durable storage. Works on all three platforms: X renders the first 4 slides and Threads up to 10 (native multi-image); on LinkedIn the slides are composed server-side into a multi-page PDF and published as a swipeable document carousel. Slides may be JPEG, PNG, WebP or GIF; WebP and GIF slides are stored as JPEG or PNG (first frame only, so an animated GIF loses its animation). A post holds one media format at a time (single image, carousel or video): replace=true swaps an existing image or video for this carousel. Published posts cannot be changed. dry_run=true validates all URLs without writing. Included with paid Handler only: on Free Handler the call is refused as not included in the plan. Attaching media to an approved (ready or scheduled) post returns it to draft, and it needs approval again before it can publish. Every response carries status_before, status_after and approval_required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"post_id": "<post_id>",
"image_urls": "<image_urls>"
},
"name": "set_post_carousel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | When true, the call validates all URLs without downloading or writing. | |
| post_id | Yes | The post id to attach a carousel to. | |
| replace | No | When true, the call discards any existing single image or video on the post and attaches this carousel instead. | |
| image_urls | Yes | Ordered array of 2-10 HTTPS image URLs. Order is preserved as the carousel slide order. JPEG, PNG, WebP or GIF; WebP and GIF are stored as JPEG or PNG (first frame). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| format | No | ||
| dry_run | No | ||
| post_id | Yes | ||
| slide_count | No | ||
| document_url | No | ||
| status_after | No | ||
| carousel_urls | No | ||
| dashboard_url | No | ||
| status_before | No | ||
| thumbnail_url | No | ||
| approval_reset | No | ||
| approval_required | No |