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 |
|---|---|---|---|
account_id | integer | no | channel_account id of the Instagram account to use when the workspace has several (see channels.list). OMIT to use the workspace's connected Instagram account. |
after | string | no | Pagination cursor from a previous call's next_cursor. |
limit | integer | no | Page size, 1-50. Default 25. |
instagram.list_tagged_media
List posts the Instagram account is tagged in
Effects: read
List posts in which OTHER Instagram users tagged the connected Business/Creator account (tagged photos, Reels and carousels, including collaborative posts). instagram.list_media shows only the account's own posts, so a contest's entries tagging the brand or a partner's collab post are found here. Returns id, caption, media_type, permalink, media_url, thumbnail_url, timestamp, username of the author, like_count, comments_count.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
account_id | integer | no | channel_account id of the Instagram account to use when the workspace has several (see channels.list). OMIT to use the workspace's connected Instagram account. |
after | string | no | Pagination cursor from a previous call's next_cursor. |
limit | integer | no | Page size, 1-50. Default 25. |
instagram.update_media
Update Instagram media caption
Effects: send, external_api
Update the caption of a published Instagram photo or Reel. Only caption is editable after publish (Instagram limitation).
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
account_id | integer | no | channel_account id of the Instagram account to use when the workspace has several (see channels.list). OMIT to use the workspace's connected Instagram account. |
caption | string | yes | New caption (max 2200 chars). |
media_id | string | yes | Instagram media ID (from list_media or thread metadata). |