instagram.list_media
List Instagram media
Effects: read
List photos and Reels on the connected Instagram Business/Creator account. Returns id, caption, media_type, permalink, thumbnail_url, timestamp.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
after | string | no | Pagination cursor from a previous call's next_cursor. |
limit | integer | no | Page size, 1-50. Default 25. |
instagram.publish_media
Publish media to Instagram
Effects: write
Publish a photo (IMAGE) or video (REELS) from workspace files to a connected Instagram Business/Creator account. Returns media_id + permalink. Instagram allows ~25 publishes per day.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
caption | string | no | Post caption (max 2200 chars). OMIT to publish without caption. |
file_id | integer | yes | Workspace files.id of the photo or video to publish. |
location_id | string | no | Facebook Place ID for location tag. |
media_type | string | no | 'auto' (default, detects from mime), 'image', or 'reels'. (one of auto, image, reels; default auto) |
share_to_feed | boolean | no | For Reels: also show on profile grid (default true). (default True) |
instagram.update_media
Update Instagram media caption
Effects: write
Update the caption of a published Instagram photo or Reel. Only caption is editable after publish (Instagram limitation).
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
caption | string | yes | New caption (max 2200 chars). |
media_id | string | yes | Instagram media ID (from list_media or thread metadata). |