Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

69.8 KB
Raw Blame
{"jsonrpc":"2.0","id":1,"result":{"logs":["composio: 36 tool(s) listed"],"result":{"tools":[{"function":{"description":"Create a draft carousel post with multiple images/videos before publishing. Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in under 24 hours, so publish promptly after creation.","name":"INSTAGRAM_CREATE_CAROUSEL_CONTAINER","parameters":{"properties":{"caption":{"description":"Caption for the carousel post (maximum 2,200 characters) Maximum 30 hashtags.","maxLength":2200,"title":"Caption","type":"string"},"child_image_files":{"description":"List of local image files to include as carousel children. Images must meet Instagram's requirements: JPEG format, aspect ratio between 4:5 (0.8) and 1.91:1, width between 320-1440px (images below 320px are scaled up, larger images are downscaled), maximum file size 8MB. Total carousel items across all sources must be between 2 and 10.","items":{"file_uploadable":true,"format":"path","title":"FileUploadable","type":"string"},"title":"Child Image Files","type":"array"},"child_image_urls":{"description":"List of image URLs to include as carousel children. Images must meet Instagram's requirements: JPEG format, aspect ratio between 4:5 (0.8) and 1.91:1, width between 320-1440px (images below 320px are scaled up, larger images are downscaled), maximum file size 8MB. URLs must be publicly accessible by Instagram's servers. Total carousel items across all sources must be between 2 and 10. Must be direct HTTPS URLs (not HTML pages, redirects, or generic Google Drive share links); use a public direct-download link.","items":{"type":"string"},"title":"Child Image Urls","type":"array"},"child_video_files":{"description":"List of local video files to include as carousel children. Videos must meet Instagram's requirements: MP4 or MOV format, aspect ratio between 4:5 (0.8) and 1.91:1, duration 3-60 seconds, maximum file size 4GB. Total carousel items across all sources must be between 2 and 10.","items":{"file_uploadable":true,"format":"path","title":"FileUploadable","type":"string"},"title":"Child Video Files","type":"array"},"child_video_urls":{"description":"List of video URLs to include as carousel children. Videos must meet Instagram's requirements: MP4 or MOV format, aspect ratio between 4:5 (0.8) and 1.91:1, duration 3-60 seconds, maximum file size 4GB. URLs must be publicly accessible by Instagram's servers. Total carousel items across all sources must be between 2 and 10. Must be direct HTTPS URLs (not HTML pages, redirects, or generic Google Drive share links).","items":{"type":"string"},"title":"Child Video Urls","type":"array"},"children":{"description":"List of child creation_ids (image/video items). Total carousel items across all sources must be between 2 and 10. All child containers must be in FINISHED status before use; pending or failed items will block carousel creation. Order of IDs determines slide sequence.","items":{"type":"string"},"title":"Children","type":"array"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID Must be a Business or Creator account; personal accounts are rejected.","title":"Ig User Id","type":"string"}},"required":["ig_user_id"],"title":"CreateCarouselContainerRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_POST_IG_USER_MEDIA instead. Creates a draft media container for photos/videos/reels before publishing. Business/Creator accounts only — personal accounts unsupported. Returns a container ID (data.id or data.creation_id) used as creation_id for publishing. Containers expire in ~24 hours — recreate stale containers rather than reusing old IDs. Before publishing via INSTAGRAM_CREATE_POST, call INSTAGRAM_GET_POST_STATUS and wait for FINISHED status — publishing before FINISHED triggers error 9007. Each creation_id is one-time-use; if container creation fails (status_code='ERROR'), fix media params and recreate via this tool rather than retrying publish with the failed ID.","name":"INSTAGRAM_CREATE_MEDIA_CONTAINER","parameters":{"properties":{"caption":{"description":"Post caption text. Maximum 2,200 characters. Hashtag limit: 30 hashtags maximum per post (Instagram enforces this limit). Mention limit: 20 @mentions maximum.","title":"Caption","type":"string"},"content_type":{"description":"What you want to post: 'photo', 'video', 'reel', or 'carousel_item' (for carousel drafts)","enum":["photo","video","reel","carousel_item"],"title":"Content Type","type":"string"},"cover_url":{"description":"Cover image URL for videos. For feed videos (content_type='video'), if image_url is not provided, this will be used as the required thumbnail. For reels, this is optional.","title":"Cover Url","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID (numeric string like '17841400008460056'). Optional - defaults to the current authenticated user. Do NOT pass Composio connection IDs (starting with 'ca_') or other auth identifiers.","title":"Ig User Id","type":"string"},"image_url":{"description":"Public URL of the image. CRITICAL REQUIREMENTS: (1) Must be a DIRECT link to the raw image file - no redirects, no authentication, no HTML wrappers. (2) Must be publicly accessible by Meta's crawlers (URLs from Google Drive, dynamic API endpoints, or generated URLs like 'backend.composio.dev/dynamic-module-load/...' will NOT work). (3) Must return proper HTTP 200 status with correct Content-Type header (image/jpeg or image/png). (4) Supported formats: JPG, PNG (WebP not supported). Max 8MB, min 320px width, aspect ratio 4:5 to 1.91:1. RECOMMENDED: Use image hosting services like Imgur, Cloudinary, AWS S3 (public), or similar that provide direct download URLs. For feed videos (content_type='video'), this parameter is required as a thumbnail.","title":"Image Url","type":"string"},"is_carousel_item":{"description":"Legacy parameter to mark media as a carousel item. Prefer using content_type='carousel_item' instead, which automatically sets this flag. When creating carousel items, you must provide either image_url or video_url. Carousels support a maximum of 10 items; each item must independently satisfy format, size, and aspect-ratio constraints.","title":"Is Carousel Item","type":"boolean"},"media_type":{"description":"Explicit media type override (IMAGE, REELS, or CAROUSEL). If not provided, media_type is automatically inferred: IMAGE for image_url, REELS for video_url. IMPORTANT: Each media_type has specific URL requirements: IMAGE requires image_url; REELS requires video_url. NOTE: VIDEO media_type was deprecated on November 9, 2023. If VIDEO is provided, it will be automatically converted to REELS.","title":"Media Type","type":"string"},"video_url":{"description":"Public URL of the video. CRITICAL REQUIREMENTS: (1) Must be a DIRECT link to the raw video file - no redirects, no authentication, no HTML wrappers. (2) Must be publicly accessible by Meta's crawlers (URLs from Google Drive, dynamic API endpoints, or generated URLs will NOT work). (3) Must return proper HTTP 200 status with correct Content-Type header (video/mp4 or video/quicktime). (4) Supported formats: MP4, MOV. Max 100MB for feed videos, max 1GB for IGTV, min 3 seconds duration. RECOMMENDED: Use video hosting services or cloud storage like AWS S3 (public), Cloudinary, or similar.","title":"Video Url","type":"string"}},"title":"CreateMediaContainerRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH instead. Publish a draft media container to Instagram (final publishing step). Posts become immediately and publicly visible upon success — confirm intent before calling. Requires Business or Creator account with publish scopes; missing scopes return Graph error code 10. After creating a media container, Instagram may need time to process media before publishing. If called too early, error code 9007 is returned. This action automatically retries with exponential backoff (up to ~44 seconds total). For large videos, use INSTAGRAM_GET_POST_STATUS to poll until status_code='FINISHED' before calling; for carousels, all child containers must individually reach FINISHED status first. No native scheduling support — use an external scheduler to trigger this call at the desired time.","name":"INSTAGRAM_CREATE_POST","parameters":{"properties":{"creation_id":{"description":"The media container ID returned in the 'id' field from INSTAGRAM_CREATE_MEDIA_CONTAINER or INSTAGRAM_CREATE_CAROUSEL_CONTAINER. Typically a long numeric string like '17895695668004550'. IMPORTANT: Do NOT use datetime strings (e.g., '2024-01-15T10:30:00+0000') - those are unrelated fields in Instagram responses. The container ID is found in the response like: {'id': '17895695668004550'}. Containers expire after ~24 hours; recreate via INSTAGRAM_CREATE_MEDIA_CONTAINER if stale.","title":"Creation Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID. Must be a numeric string (e.g., '25162441193410545'). Personal accounts and misconfigured IDs are rejected.","title":"Ig User Id","type":"string"}},"required":["ig_user_id","creation_id"],"title":"CreatePostRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to delete a comment on Instagram media. Use when you need to remove a comment that was created by your Instagram Business or Creator Account. Note: You can only delete comments that your account created - you cannot delete other users' comments unless they are on your own media.","name":"INSTAGRAM_DELETE_COMMENT","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_comment_id":{"description":"The unique identifier of the Instagram comment to delete. This must be a comment created by your Instagram Business or Creator Account.","examples":["17871247656396682"],"title":"Ig Comment Id","type":"string"}},"required":["ig_comment_id"],"title":"DeleteCommentRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to delete messenger profile settings for an Instagram account. Use when you need to remove ice breakers, persistent menu, greeting messages, or other messaging configuration from the messenger profile.","name":"INSTAGRAM_DELETE_MESSENGER_PROFILE","parameters":{"description":"Request to delete messenger profile settings for an Instagram account.","properties":{"fields":{"description":"Array of messenger profile properties to delete. Valid values: ice_breakers, persistent_menu, get_started, greeting, account_linking_url, whitelisted_domains. Only the specified fields will be removed from the messenger profile.","examples":[["ice_breakers"],["ice_breakers","greeting"]],"items":{"description":"Valid messenger profile fields that can be deleted.","enum":["ice_breakers","persistent_menu","get_started","greeting","account_linking_url","whitelisted_domains"],"title":"MessengerProfileField","type":"string"},"title":"Fields","type":"array"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID whose messenger profile settings will be deleted.","examples":["25162441193410545"],"title":"Ig User Id","type":"string"}},"required":["ig_user_id","fields"],"title":"DeleteMessengerProfileRequest","type":"object"}},"type":"function"},{"function":{"description":"Get details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will return permission errors. Newly sent/received messages may take a few seconds to appear in results.","name":"INSTAGRAM_GET_CONVERSATION","parameters":{"properties":{"conversation_id":{"description":"The unique identifier for the Instagram conversation thread.  The thread must already exist; first-contact DMs cannot be initiated via the API — a manual first message must be sent before a conversation_id is available.This is typically a base64-encoded string obtained from the list_conversations or list_all_conversations actions. Must not be empty or contain only whitespace.","title":"Conversation Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Graph API version to use (e.g., 'v21.0'). Defaults to 'v21.0'.","title":"Graph Api Version","type":"string"}},"required":["conversation_id"],"title":"GetConversationRequest","type":"object"}},"type":"function"},{"function":{"description":"Get replies to a specific Instagram comment. Returns a list of comment replies with details like text, username, timestamp, and like count. Use when you need to retrieve child comments (replies) for a specific parent comment.","name":"INSTAGRAM_GET_IG_COMMENT_REPLIES","parameters":{"properties":{"after":{"description":"Cursor for forward pagination - get replies after this cursor","title":"After","type":"string"},"before":{"description":"Cursor for backward pagination - get replies before this cursor","title":"Before","type":"string"},"fields":{"default":"id,text,username,timestamp,like_count,hidden,from,media,parent_id,legacy_instagram_comment_id","description":"Comma-separated list of fields to return. Available fields: id, text, username, timestamp, like_count, hidden, from, media, parent_id, replies, legacy_instagram_comment_id","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Graph API version to use","title":"Graph Api Version","type":"string"},"ig_comment_id":{"description":"Instagram Comment ID to get replies for","examples":["18101534863756048"],"title":"Ig Comment Id","type":"string"},"limit":{"default":25,"description":"Number of replies to return per page (max 100)","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ig_comment_id"],"title":"GetIgCommentRepliesRequest","type":"object"}},"type":"function"},{"function":{"description":"Get a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engagement metrics, caption, media URLs, and metadata. NOTE: This action is for published media only. For unpublished container IDs (from INSTAGRAM_CREATE_MEDIA_CONTAINER), use INSTAGRAM_GET_POST_STATUS to check status instead.","name":"INSTAGRAM_GET_IG_MEDIA","parameters":{"additionalProperties":true,"properties":{"fields":{"default":"id,caption,media_type,media_url,permalink,timestamp,like_count,comments_count,media_product_type","description":"Comma-separated list of fields to return. Defaults to commonly useful fields including id, caption, media_type, media_url, permalink, timestamp, like_count, comments_count, and media_product_type. Supported fields: id, caption, comments_count, is_comment_enabled, like_count, media_type, media_url, media_product_type, owner, permalink, shortcode, thumbnail_url, timestamp, username, children, comments. For nested fields use syntax like 'children{media_url,media_type}'. UNSUPPORTED FIELDS (will cause errors): tagged_users, user_tags, location, filter_name, latitude, longitude, text. Note: Use 'caption' instead of 'text' for the media caption. INSIGHTS METRICS (use INSTAGRAM_GET_IG_MEDIA_INSIGHTS instead): plays, reach, saved, impressions, video_views, engagement. To get media where a user is tagged, use INSTAGRAM_GET_IG_USER_TAGS instead. IMPORTANT: If you receive a MediaBuilder error, the ID is an unpublished container - use INSTAGRAM_GET_POST_STATUS instead.","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use","title":"Graph Api Version","type":"string"},"ig_media_id":{"description":"The numeric ID of the Instagram media object from the Graph API (e.g., '17858625294504375'). IMPORTANT: This must be a numeric string, NOT an alphanumeric shortcode from instagram.com/p/<shortcode>/ URLs (e.g., 'DUTi4n4D9wg' is NOT valid). Obtain numeric IDs from INSTAGRAM_GET_IG_USER_MEDIA or similar endpoints. For unpublished container IDs, use INSTAGRAM_GET_POST_STATUS instead.","examples":["17858625294504375"],"title":"Ig Media Id","type":"string"}},"required":["ig_media_id"],"title":"GetIgMediaRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to get media objects (images/videos) that are children of an Instagram carousel/album post. Use when you need to retrieve individual media items from a carousel album post. Note: Carousel children media do not support insights queries - for analytics, query metrics at the parent carousel level.","name":"INSTAGRAM_GET_IG_MEDIA_CHILDREN","parameters":{"properties":{"fields":{"default":"id,media_type,media_url,permalink,timestamp","description":"Comma-separated list of fields to return for each child media item. Available fields: id, caption, media_type, media_url, username, timestamp, permalink, thumbnail_url, ig_id, owner, shortcode, is_comment_enabled, comments_count, like_count","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use","title":"Graph Api Version","type":"string"},"ig_media_id":{"description":"The ID of a CAROUSEL_ALBUM media post (not a user ID). This must be a media ID from a carousel/album post, typically obtained by calling 'Get IG User Media' action first and filtering for media_type='CAROUSEL_ALBUM'. Media IDs are numeric strings (17 digits) that identify specific Instagram posts, distinct from user/account IDs.","examples":["17858625294504375"],"title":"Ig Media Id","type":"string"}},"required":["ig_media_id"],"title":"GetIgMediaChildrenRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Business/Creator account. Supports cursor-based pagination for navigating through large comment lists. An empty data array in the response indicates the post has no comments and is not an error. Bulk-fetching across many media objects may trigger API rate limits.","name":"INSTAGRAM_GET_IG_MEDIA_COMMENTS","parameters":{"properties":{"after":{"description":"Cursor for forward pagination. Use the cursor value from previous response's paging.cursors.after field","title":"After","type":"string"},"before":{"description":"Cursor for backward pagination. Use the cursor value from previous response's paging.cursors.before field","title":"Before","type":"string"},"fields":{"default":"id,text,username,timestamp,like_count,from,hidden,media,parent_id","description":"Comma-separated list of fields to retrieve for each comment. Available fields: id, text, username, timestamp, like_count, replies, from, hidden, media, parent_id, user","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use","title":"Graph Api Version","type":"string"},"ig_media_id":{"description":"The ID of the Instagram media object (post/photo/video/album) to retrieve comments from. Must be a Media ID, not a User ID. Media IDs can be obtained from endpoints like GET /ig-user-id/media. Media IDs typically look like '17858625294504375'. The media must belong to the connected Business/Creator account; media from other accounts will return empty data or an error.","examples":["17858625294504375"],"title":"Ig Media Id","type":"string"},"limit":{"default":25,"description":"Number of comments to return per page (typically 50-100)","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ig_media_id"],"title":"GetIgMediaCommentsRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). Use when you need to retrieve performance data such as views, reach, likes, comments, saves, and shares for specific media. Note: Insights data is only available for media published within the last 2 years, and the account must have at least 1,000 followers. Requires a Business or Creator account; personal Instagram profiles are not supported.","name":"INSTAGRAM_GET_IG_MEDIA_INSIGHTS","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use","title":"Graph Api Version","type":"string"},"ig_media_id":{"description":"The ID of the Instagram media object (photo, video, reel, carousel album) for which to retrieve insights","examples":["18044673371703564"],"title":"Ig Media Id","type":"string"},"metric":{"description":"List of metrics to retrieve. Must be provided as an array of strings, e.g., ['reach', 'saved', 'likes']. COMMONLY SUPPORTED METRICS: views, reach, saved, likes, comments, shares, total_interactions. REELS-SPECIFIC METRICS: ig_reels_video_view_total_time, ig_reels_avg_watch_time, reels_skip_rate, facebook_views, crossposted_views. STORIES-SPECIFIC METRICS: replies, navigation, follows, profile_visits. DEPRECATED METRICS (will be filtered out): 'impressions', 'plays', 'video_views', 'clips_replays_count', 'ig_reels_aggregated_all_plays_count' (use 'views' instead); 'taps_forward', 'taps_back', 'exits' (Story navigation metrics deprecated in API v18+, use 'navigation' instead). INVALID METRIC NAMES (will be rejected): 'clicks', 'engagement' are NOT valid metric names.","examples":[["views","reach","likes","comments","saved"]],"items":{"type":"string"},"title":"Metric","type":"array"},"period":{"default":"lifetime","description":"The time period for metric aggregation. For media insights, 'lifetime' is the default and typically the only available option. Note: You can only request metrics for one period type per request.","title":"Period","type":"string"}},"required":["ig_media_id","metric"],"title":"GetIgMediaInsightsRequest","type":"object"}},"type":"function"},{"function":{"description":"Get an Instagram Business Account's current content publishing usage. Use this to monitor quota usage before publishing; exceeding the daily cap blocks new posts until the quota resets (no partial failure — new publish calls are rejected until reset). IMPORTANT: This endpoint requires an IG User ID (Instagram Business Account ID), NOT an IGSID (Instagram Scoped ID). IGSID is only used for messaging-related endpoints. Content publishing endpoints require a proper IG User ID. Excessive polling of this endpoint may trigger Graph error 613 (rate limit); space calls several seconds apart.","name":"INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT","parameters":{"properties":{"fields":{"default":"quota_usage,config","description":"Comma-separated list of fields to return. Available fields: quota_usage, config. Defaults to 'quota_usage,config'.","examples":["quota_usage","config","quota_usage,config"],"title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Facebook Graph API version to use","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID (IG User ID). Must be a valid IG User ID, NOT an IGSID/scoped ID (used for messaging). Defaults to 'me' for current user. To get your IG User ID, use GET /{facebook-page-id}?fields=instagram_business_account.","title":"Ig User Id","type":"string"}},"title":"GetIgUserContentPublishingLimitRequest","type":"object"}},"type":"function"},{"function":{"description":"Get live media objects during an active Instagram broadcast. Returns the live video media ID and metadata when a live broadcast is in progress on an Instagram Business or Creator account. Use this to monitor active live streams and access real-time engagement data.","name":"INSTAGRAM_GET_IG_USER_LIVE_MEDIA","parameters":{"properties":{"fields":{"default":"id,media_type,media_url,timestamp,permalink","description":"Comma-separated list of fields to return for the live media object. Available fields: id, media_type, media_url, timestamp, permalink. Defaults to all available fields.","examples":["id","id,media_type,timestamp","id,media_type,media_url,timestamp,permalink"],"title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Facebook Graph API version to use","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business or Creator Account ID (optional, defaults to 'me' for current user). Must be an account with an active live broadcast.","title":"Ig User Id","type":"string"}},"title":"GetIgUserLiveMediaRequest","type":"object"}},"type":"function"},{"function":{"description":"Get Instagram user's media collection (posts, photos, videos, reels, carousels). Use when you need to retrieve all media published by an Instagram Business or Creator account with support for pagination and time-based filtering.","name":"INSTAGRAM_GET_IG_USER_MEDIA","parameters":{"properties":{"after":{"description":"Cursor for forward pagination - retrieve media after this cursor Value comes from paging.cursors.after in the response; stopping at the first page silently omits older posts.","title":"After","type":"string"},"auto_resolve_fb_page_id":{"default":true,"description":"If true and the provided ig_user_id fails, automatically attempt to resolve it as a Facebook Page ID by retrieving the instagram_business_account field. Set to false to disable this behavior.","title":"Auto Resolve Fb Page Id","type":"boolean"},"before":{"description":"Cursor for backward pagination - retrieve media before this cursor","title":"Before","type":"string"},"fields":{"default":"id,caption,media_type,media_url,permalink,thumbnail_url,timestamp,username","description":"Comma-separated list of fields to return. Available fields: id, caption, media_type, media_url, permalink, thumbnail_url, timestamp, username, comments_count, like_count, ig_id, is_comment_enabled, owner, shortcode, media_product_type, video_title, children{media_url,media_type,thumbnail_url} Reels appear as media_type=VIDEO and media_product_type=REELS; filter both fields to identify reels. media_url is a direct file URL; permalink is the user-facing share link. Optional fields like caption and like_count may be null or absent in the response.","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use (e.g., 'v21.0')","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business or Creator Account ID. Use 'me' for the authenticated user, or provide the numeric ID obtained from the Instagram Graph API (typically 17 digits, e.g., '17841405793187218'). If you provide a Facebook Page ID, it will be automatically converted to the Instagram Business Account ID.","examples":["me","17841405793187218"],"minLength":2,"title":"Ig User Id","type":"string"},"limit":{"default":25,"description":"Number of media items to return per page (default: 25, max: 100)","maximum":100,"minimum":1,"title":"Limit","type":"integer"},"since":{"description":"Unix timestamp - filter results to media created after this time. If both 'since' and 'until' are provided, 'since' must be less than 'until'.","title":"Since","type":"integer"},"until":{"description":"Unix timestamp - filter results to media created before this time. If both 'since' and 'until' are provided, 'since' must be less than 'until'.","title":"Until","type":"integer"}},"required":["ig_user_id"],"title":"GetIgUserMediaRequest","type":"object"}},"type":"function"},{"function":{"description":"Get active story media objects for an Instagram Business or Creator account. Stories are retrieved via the /stories endpoint. Returns stories that are currently active within the 24-hour window. Use this to retrieve story content, metadata, and engagement metrics for monitoring or analytics purposes.","name":"INSTAGRAM_GET_IG_USER_STORIES","parameters":{"properties":{"after":{"description":"Cursor for pagination to get the next page of results. Use the 'after' cursor from the previous response's paging object.","title":"After","type":"string"},"before":{"description":"Cursor for pagination to get the previous page of results. Use the 'before' cursor from the previous response's paging object.","title":"Before","type":"string"},"fields":{"default":"id,media_type,media_url,permalink,timestamp","description":"Comma-separated list of fields to return for each story. Available fields: id, caption, comments_count, ig_id, is_comment_enabled, like_count, media_type, media_url, owner, permalink, shortcode, thumbnail_url, timestamp, username. If not specified, defaults to id, media_type, media_url, permalink, and timestamp.","examples":["id","id,media_type,timestamp","id,media_type,media_url,permalink,timestamp,caption"],"title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"Facebook Graph API version to use","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business or Creator Account ID (optional, defaults to 'me' for current user). Must be an account with active stories within the 24-hour window. Must be a numeric ID; usernames are not accepted.","title":"Ig User Id","type":"string"},"limit":{"description":"Number of stories to return per page for pagination. If not specified, returns all active stories.","minimum":1,"title":"Limit","type":"integer"}},"title":"GetIgUserStoriesRequest","type":"object"}},"type":"function"},{"function":{"description":"Get Instagram media where the user has been tagged by other users. Use when you need to retrieve all media in which an Instagram Business or Creator account has been tagged, including tags in captions, comments, or on the media itself.","name":"INSTAGRAM_GET_IG_USER_TAGS","parameters":{"properties":{"after":{"description":"Cursor for forward pagination - retrieve media after this cursor","title":"After","type":"string"},"before":{"description":"Cursor for backward pagination - retrieve media before this cursor","title":"Before","type":"string"},"fields":{"default":"id,caption,media_type,media_url,permalink,timestamp,username","description":"Comma-separated list of fields to return. Available fields: id, caption, comments_count, ig_id, is_comment_enabled, like_count, media_product_type, media_type, media_url, owner, permalink, shortcode, thumbnail_url, timestamp, username, video_title. If not specified, defaults to commonly used fields.","title":"Fields","type":"string"},"graph_api_version":{"description":"Instagram Graph API version (e.g., 'v21.0'). If not specified, uses v21.0 as default.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business or Creator Account ID. Use 'me' for the authenticated user's account.","examples":["me","17841405793187218","25162441193410545"],"title":"Ig User Id","type":"string"},"limit":{"default":25,"description":"Number of tagged media items to return per page (default: 25, max: 100)","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ig_user_id"],"title":"GetIgUserTagsRequest","type":"object"}},"type":"function"},{"function":{"description":"Get the messenger profile settings for an Instagram account. Returns ice breakers and other messaging configuration. Use when you need to retrieve messaging settings, ice breaker questions, or messenger configuration for an Instagram Business account.","name":"INSTAGRAM_GET_MESSENGER_PROFILE","parameters":{"properties":{"fields":{"description":"Comma-separated list of messenger profile fields to retrieve. Available options: ice_breakers, greeting, persistent_menu, get_started, account_linking_url, whitelisted_domains. If not provided, all available fields will be returned.","title":"Fields","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Graph API version to use (e.g., 'v21.0'). Defaults to 'v21.0'.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"The Instagram User ID for which to retrieve messenger profile settings","title":"Ig User Id","type":"string"}},"required":["ig_user_id"],"title":"GetMessengerProfileRequest","type":"object"}},"type":"function"},{"function":{"description":"Get Instagram conversations for a Page connected to an Instagram Business account. Use platform=instagram parameter to filter for Instagram conversations only.","name":"INSTAGRAM_GET_PAGE_CONVERSATIONS","parameters":{"properties":{"after":{"description":"Cursor for pagination to get the next page of results.","title":"After","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Graph API version to use (e.g., 'v21.0'). Defaults to 'v21.0'.","title":"Graph Api Version","type":"string"},"limit":{"default":25,"description":"Maximum number of conversations to return per page.","maximum":200,"minimum":1,"title":"Limit","type":"integer"},"page_id":{"description":"Instagram user ID or page ID to get conversations for. This is the Instagram Business Account ID that can be obtained from the /me endpoint.","examples":["25162441193410545"],"title":"Page Id","type":"string"},"platform":{"default":"instagram","description":"Platform to filter conversations. Set to 'instagram' to get Instagram conversations only.","examples":["instagram"],"title":"Platform","type":"string"}},"required":["page_id"],"title":"GetPageConversationsRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_GET_IG_MEDIA_COMMENTS instead. Get comments on an Instagram post. Requires Instagram Business or Creator account. Returns empty `data` array (not an error) when no comments exist. Response data is nested under `data.data`; unwrap before processing. Timestamps are timezone-aware ISO 8601 strings; use UTC-based comparison.","name":"INSTAGRAM_GET_POST_COMMENTS","parameters":{"properties":{"after":{"description":"Cursor for pagination - get comments after this cursor Value comes from `paging.cursors.after` in the response.","title":"After","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_post_id":{"description":"Instagram Post ID","title":"Ig Post Id","type":"string"},"limit":{"default":25,"description":"Number of comments to return (max 100)","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["ig_post_id"],"title":"GetPostCommentsRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_GET_IG_MEDIA_INSIGHTS instead. Get Instagram post insights/analytics (impressions, reach, engagement, etc.). Requires a Business or Creator account; personal accounts cannot access insights. Metrics may be unavailable for several minutes after publishing; verify post status is FINISHED before calling.","name":"INSTAGRAM_GET_POST_INSIGHTS","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_post_id":{"description":"Numeric Instagram Media ID from the Graph API (e.g., '17895695668004196'). This must be the numeric ID, NOT the shortcode from Instagram URLs (e.g., 'DT0ndbTgcLH' from instagram.com/p/DT0ndbTgcLH/ will NOT work). Use INSTAGRAM_GET_IG_USER_MEDIA to obtain valid numeric media IDs.","title":"Ig Post Id","type":"string"},"metric":{"description":"Metrics to retrieve for the media. If not provided and metric_preset is not set, uses auto_safe preset. Allowed metrics vary by media_product_type: IMAGE/CAROUSEL: reach, likes, comments, saved, shares. VIDEO: reach, plays, likes, comments, saved, shares. REELS: reach, likes, comments, saved, shares, total_interactions, ig_reels_video_view_total_time, ig_reels_avg_watch_time, clips_replays_count, ig_reels_aggregated_all_plays_count, views, reels_skip_rate. Note: 'plays' may not work consistently for all reel types - use 'views' instead (plays is being deprecated in API v22). Stories: reach, replies, taps_forward, taps_back, exits. Note: 'engagement' and 'impressions' are NOT valid standalone metrics - use individual metrics like likes, comments, saved, shares instead. If a metric is unsupported for the post type, API returns 400 error. Some metrics (e.g., shares) may return null even for supported media types; handle missing values before computing ratios.","items":{"type":"string"},"title":"Metric","type":"array"},"metric_preset":{"default":"auto_safe","description":"Predefined metric sets for different media types to avoid API errors.","enum":["auto_safe","image_basic","video_basic","reel_basic","carousel_basic"],"title":"MetricPreset","type":"string"}},"required":["ig_post_id"],"title":"GetPostInsightsRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use GetIgMedia instead. Check the processing status of a draft post container. Poll until status_code='FINISHED' before calling INSTAGRAM_CREATE_POST; publishing early triggers OAuthException 9007 (HTTP 400). If status_code='ERROR' or remains non-terminal after ~30 attempts, the container is permanently failed — recreate a new container. Poll every 3–5s with exponential backoff to avoid error 613/code 4/HTTP 429. For carousels, all child containers must reach FINISHED before publishing the parent.","name":"INSTAGRAM_GET_POST_STATUS","parameters":{"properties":{"creation_id":{"description":"The media container ID returned from INSTAGRAM_CREATE_MEDIA_CONTAINER action. This is a numeric string (e.g., '17843131380645284') that uniquely identifies the media container. Use this ID to check the container's publishing status before calling the publish endpoint. Sourced from the data.id field (not data.creation_id) in the INSTAGRAM_CREATE_MEDIA_CONTAINER response. Containers expire after ~24 hours; do not reuse an expired creation_id.","title":"Creation Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"}},"required":["creation_id"],"title":"GetPostStatusRequest","type":"object"}},"type":"function"},{"function":{"description":"Get Instagram Business Account info including profile details and statistics. IMPORTANT: Only works for Business/Creator accounts you manage through Facebook Business Manager. Cannot query arbitrary public Instagram accounts. Use \"me\" to query your own authenticated account. NOTE: followers_count and follows_count are ONLY available when querying your own profile with ig_user_id=\"me\" - these fields return null for specific user IDs due to Instagram Graph API limitations.","name":"INSTAGRAM_GET_USER_INFO","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID. IMPORTANT: You can only query Business/Creator accounts that you manage through Facebook Business Manager. Use \"me\" to query your own authenticated account. To query other accounts you manage, provide their numeric Business Account ID. Arbitrary public accounts cannot be queried. If not provided, defaults to \"me\".","title":"Ig User Id","type":"string"}},"title":"GetUserInfoRequest","type":"object"}},"type":"function"},{"function":{"description":"Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). Requires a Business or Creator account; personal accounts are not supported. Returned timestamps are in UTC. metric_type (time_series or total_value): When set to total_value, the API returns a total_value object instead of values. breakdown: Only applicable when metric_type=total_value and only for supported metrics. timeframe: Required for demographics-related metrics and overrides since/until for those metrics.","name":"INSTAGRAM_GET_USER_INSIGHTS","parameters":{"properties":{"breakdown":{"description":"Breakdown to use when metric_type=total_value. Allowed values: contact_button_type, follow_type, media_product_type, age, city, country, gender.","title":"Breakdown","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID - must be a numeric ID (e.g., '17841400008460056'). Content API IDs with 'ca_' prefix are not supported. Optional, defaults to current user.","title":"Ig User Id","type":"string"},"metric":{"description":"Metrics to retrieve for the user account. Accepts a list of metric names or a comma-separated string. Core metrics: reach, follower_count, online_followers. Engagement metrics: accounts_engaged, total_interactions, likes, comments, shares, saves, replies. Activity metrics: follows_and_unfollows, profile_links_taps, views. Demographics metrics (require timeframe parameter): engaged_audience_demographics, reached_audience_demographics, follower_demographics. Threads metrics: threads_likes, threads_replies, reposts, quotes, threads_followers, etc. If multiple metrics are provided, all must support the same period. DEPRECATED (January 2025, Graph API v21+): impressions, email_contacts, phone_call_clicks, text_message_clicks, get_directions_clicks, profile_views, and website_clicks are no longer supported.","items":{"description":"Valid metrics for Instagram account-level insights.\n\nCore metrics:\n- reach, follower_count, online_followers\n\nEngagement metrics:\n- accounts_engaged, total_interactions, likes, comments, shares, saves, replies\n\nActivity metrics:\n- follows_and_unfollows, profile_links_taps, views\n\nDemographics metrics (require timeframe parameter):\n- engaged_audience_demographics, reached_audience_demographics, follower_demographics\n\nThreads metrics (for Threads integration):\n- threads_likes, threads_replies, reposts, quotes, threads_followers,\n  threads_follower_demographics, content_views, threads_views, threads_clicks, threads_reposts\n\nDEPRECATED (January 8, 2025 - Graph API v21+): The following metrics are no longer supported\nand will return errors if requested:\n- impressions, email_contacts, phone_call_clicks, text_message_clicks, get_directions_clicks,\n  profile_views, website_clicks","enum":["reach","follower_count","online_followers","accounts_engaged","total_interactions","likes","comments","shares","saves","replies","follows_and_unfollows","profile_links_taps","views","engaged_audience_demographics","reached_audience_demographics","follower_demographics","threads_likes","threads_replies","reposts","quotes","threads_followers","threads_follower_demographics","content_views","threads_views","threads_clicks","threads_reposts"],"title":"UserInsightMetric","type":"string"},"title":"Metric","type":"array"},"metric_type":{"description":"Aggregation type for results. Allowed values: time_series, total_value.","title":"Metric Type","type":"string"},"period":{"default":"day","description":"Valid period values for Instagram user insights aggregation.\n\nAvailable periods:\n- day: Daily aggregation\n- week: Weekly aggregation\n- days_28: 28-day aggregation\n- lifetime: Lifetime aggregation (for audience-related metrics)","enum":["day","week","days_28","lifetime"],"title":"InsightPeriod","type":"string"},"since":{"description":"Start of time range (inclusive) as a Unix timestamp (seconds). Also accepts date strings (YYYY-MM-DD or ISO 8601 format) which will be converted to timestamps.","title":"Since","type":"integer"},"timeframe":{"description":"Valid timeframe values for demographics-related Instagram user insights.\n\nRequired for engaged_audience_demographics and reached_audience_demographics metrics.\nOverrides since/until parameters when specified.\n\nNote: As of 2025, Instagram deprecated the following timeframe values for demographics metrics:\nlast_14_days, last_30_days, last_90_days, and prev_month. Only this_week and this_month are\ncurrently supported by the Instagram Graph API.\n\nThe follower_demographics metric uses period=lifetime and does not support the timeframe parameter.","enum":["this_month","this_week"],"title":"InsightTimeframe","type":"string"},"until":{"description":"End of time range (inclusive) as a Unix timestamp (seconds). Also accepts date strings (YYYY-MM-DD or ISO 8601 format) which will be converted to timestamps.","title":"Until","type":"integer"}},"title":"GetUserInsightsRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_GET_IG_USER_MEDIA instead. Get Instagram user's media (posts, photos, videos). Only works for connected Business or Creator accounts; personal accounts return no data. Response data is nested under `data.data`; unwrap before processing. Items mix images, videos, carousels, and reels — filter by `media_type` and `media_product_type`. Use `media_url` for file download, `permalink` for share links. Fields like `caption`, `like_count` may be null. Timestamps are UTC ISO 8601. HTTP 429 with `Retry-After` header indicates rate limiting.","name":"INSTAGRAM_GET_USER_MEDIA","parameters":{"properties":{"after":{"description":"Cursor for pagination - get media after this cursor Chain calls using `paging.cursors.after` from the response to paginate; set an upper bound (e.g., ~300 posts) to avoid unbounded loops.","title":"After","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Numeric Instagram Business Account ID (NOT username). Must be a numeric ID like '17841405793187218'. Omit or leave empty to get the current authenticated user's media. To find an account's numeric ID, use the INSTAGRAM_GET_USER_INFO action.","title":"Ig User Id","type":"string"},"limit":{"default":25,"description":"Number of media items to return (max 100) A single call may not return all media; paginate via `after` for complete results.","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"GetUserMediaRequest","type":"object"}},"type":"function"},{"function":{"description":"List all Instagram DM conversations for the authenticated user. Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response conversations are nested under `data.data` — accessing top-level `data` as the final list returns zero items. An empty `data` list is a valid non-error outcome meaning no conversations exist in scope.","name":"INSTAGRAM_LIST_ALL_CONVERSATIONS","parameters":{"properties":{"after":{"description":"Cursor for pagination Obtain from `paging.cursors.after` in the response; absence of `paging.cursors.after` or `paging.next` signals end-of-results.","title":"After","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID (optional for /me/conversations)","title":"Ig User Id","type":"string"},"limit":{"default":25,"description":"Maximum number of conversations to return.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"title":"ListInstagramConversationsRequest","type":"object"}},"type":"function"},{"function":{"description":"List all messages from a specific Instagram DM conversation. Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response data is nested under data.data (double-wrapped); attachment-only messages may have empty text fields.","name":"INSTAGRAM_LIST_ALL_MESSAGES","parameters":{"properties":{"after":{"description":"Cursor for paginationPass paging.cursors.after from the previous response to fetch the next page. Stop when paging.cursors.after or paging.next is absent.","title":"After","type":"string"},"conversation_id":{"description":"Unique identifier for the Instagram conversation. Obtain this by calling the INSTAGRAM_LIST_ALL_CONVERSATIONS action, which returns conversation IDs in the format 'aWdfZAG06...' (base64-encoded string).","title":"Conversation Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"limit":{"default":25,"description":"Maximum number of messages to return.","maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["conversation_id"],"title":"ListInstagramMessagesRequest","type":"object"}},"type":"function"},{"function":{"description":"Mark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is visible to the other party and changes inbox read state — use with explicit user approval in automated or bulk flows. IMPORTANT LIMITATIONS: - The sender_action API feature may have limited support on Instagram - The recipient must have an active 24-hour messaging window open - Requires instagram_manage_messages permission - Only works with Instagram Business or Creator accounts If this action fails with a 500 error, it may indicate that the sender_action feature is not supported for your Instagram account or the specific recipient.","name":"INSTAGRAM_MARK_SEEN","parameters":{"description":"Request to mark Instagram DM messages as read/seen using the sender_action API.\n\nNOTE: The sender_action feature (mark_seen, typing_on, typing_off) is primarily\ndocumented for Facebook Messenger. Support on Instagram Messaging API may be\nlimited or require specific account configurations.\n\nThe recipient must have an active conversation with your Instagram Business/Creator\naccount, and the 24-hour messaging window must be open (user must have messaged\nyour account within the last 24 hours).","properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use (e.g., 'v21.0').","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID. Optional - when not provided, the /me/messages endpoint is used instead of /{ig_user_id}/messages.","title":"Ig User Id","type":"string"},"recipient_id":{"description":"Instagram-Scoped User ID (IGSID) of the recipient. This is a numeric string obtained from conversation participants (e.g., '17841479358498320'). The recipient must have an existing conversation with your Instagram Business/Creator account. In multi-participant threads, use the individual participant's IGSID, not a group or thread identifier.","title":"Recipient Id","type":"string"}},"required":["recipient_id"],"title":"MarkSeenRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300 characters or less, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters.","name":"INSTAGRAM_POST_IG_COMMENT_REPLIES","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_comment_id":{"description":"The unique identifier of the Instagram comment to which you want to reply. This is the ID of the parent comment that will receive the reply.","examples":["18542901907038144"],"title":"Ig Comment Id","type":"string"},"message":{"description":"The text content of the reply to be posted. Maximum length: 300 characters. Maximum 4 hashtags allowed. Maximum 1 URL allowed. Cannot consist entirely of capital letters.","examples":["This is a test reply via Instagram Graph API","Thank you for your comment!"],"title":"Message","type":"string"}},"required":["ig_comment_id","message"],"title":"PostIgCommentRepliesRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to create a comment on an Instagram media object. Use when you need to post a comment on a specific Instagram post, photo, video, or carousel. The comment must be 300 characters or less, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters.","name":"INSTAGRAM_POST_IG_MEDIA_COMMENTS","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_media_id":{"description":"The unique identifier of the Instagram media object where the comment will be posted. This is the ID of the Instagram post, photo, video, or carousel.","examples":["17858625294504375"],"title":"Ig Media Id","type":"string"},"message":{"description":"The text content of the comment to be posted on the media object. Maximum length: 300 characters. Maximum 4 hashtags allowed. Maximum 1 URL allowed. Cannot consist entirely of capital letters.","examples":["This is a great post!","Love this! #awesome"],"title":"Message","type":"string"}},"required":["ig_media_id","message"],"title":"PostIgMediaCommentsRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publishing process - after creating the container, use the media_publish endpoint to publish it.","name":"INSTAGRAM_POST_IG_USER_MEDIA","parameters":{"additionalProperties":true,"properties":{"audio_name":{"description":"For Reels - custom name for the audio track (default: 'Original Audio').","examples":["My Custom Audio"],"title":"Audio Name","type":"string"},"caption":{"description":"Caption text for the post. Use HTML URL encoding for hashtags (# becomes %23).","examples":["Testing Instagram API","Check out this post! #awesome"],"title":"Caption","type":"string"},"children":{"description":"For carousel posts - array of container IDs (2-10 items) from previously created media containers.","examples":[["17842618866645284","17842618866645285"]],"items":{"type":"string"},"title":"Children","type":"array"},"collaborators":{"description":"Array of up to 3 public Instagram usernames to tag as collaborators. Supported for images, videos, and parent carousel containers (not Stories or carousel child items). Cannot be used when is_carousel_item=true - collaborators must be set on the parent carousel container instead.","examples":[["username1","username2"]],"items":{"type":"string"},"title":"Collaborators","type":"array"},"cover_url":{"description":"For Reels - MUST be a valid HTTP/HTTPS URL pointing to a custom cover image. Must start with 'http://' or 'https://'. IMPORTANT: URLs with query parameters (like signed URLs) are NOT supported by Instagram. Use direct, publicly accessible URLs without query strings. If both cover_url and thumb_offset provided, cover_url takes precedence.","examples":["https://example.com/cover.jpg"],"pattern":"^https?://","title":"Cover Url","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"The unique identifier of the Instagram Business account (IG User ID) to create media for. This must be an Instagram Business account.","examples":["17841405309211844"],"title":"Ig User Id","type":"string"},"image_file":{"description":"Local image file to upload. FileUploadable object where 'name' is the filename. The file will be uploaded to a temporary public URL for Instagram to fetch. At least one of: image_url, image_file, video_url, video_file, or children must be provided.","file_uploadable":true,"format":"path","title":"FileUploadable","type":"string"},"image_url":{"description":"MUST be a valid HTTP/HTTPS URL pointing to a publicly accessible JPEG image file. Must start with 'http://' or 'https://' (e.g., 'https://example.com/image.jpg'). IMPORTANT: URLs with query parameters (like AWS S3 signed URLs with authentication tokens) are NOT supported by Instagram and will be rejected. Use direct, publicly accessible URLs without query strings. DO NOT pass image descriptions or text - only actual URLs are accepted. At least one of: image_url, image_file, video_url, video_file, or children must be provided.","examples":["https://example.com/image.jpg","https://cdn.example.com/photos/my-photo.jpeg"],"pattern":"^https?://","title":"Image Url","type":"string"},"is_carousel_item":{"description":"Indicates this container is part of a carousel. For carousels: create 2-10 individual containers, then create a parent carousel container with their IDs. When true, collaborators cannot be set on this child item - they must be set on the parent carousel container instead.","title":"Is Carousel Item","type":"boolean"},"location_id":{"description":"Facebook Page ID of a location to tag. The Page must have latitude/longitude data.","examples":["123456789"],"title":"Location Id","type":"string"},"media_type":{"description":"Media type for the container. Valid values: 'REELS' (for video content), 'CAROUSEL' (for carousel posts with children), 'STORIES' (for story posts). When posting video content with video_url alone (no image_url), this will automatically default to 'REELS' if not specified. Note: 'VIDEO' is deprecated and no longer supported - use 'REELS' for all video content.","enum":["REELS","CAROUSEL","STORIES"],"examples":["REELS"],"title":"Media Type","type":"string"},"share_to_feed":{"description":"For Reels - whether to share to both Feed and Reels tabs. Only applicable when media_type is REELS.","title":"Share To Feed","type":"boolean"},"thumb_offset":{"description":"For videos/Reels - millisecond offset for thumbnail frame (default: 0).","examples":[1000],"title":"Thumb Offset","type":"integer"},"user_tags":{"description":"Array of user tag objects for tagging public Instagram accounts. For images: x and y coordinates (0.0-1.0, from top-left) are REQUIRED. For Reels: only username is allowed; x/y coordinates CANNOT be used.","examples":[[{"username":"testuser","x":0.5,"y":0.5}]],"items":{"description":"Model representing a user tag for Instagram media.\n\nUser tags allow tagging public Instagram accounts in media posts.\nFor images: x and y coordinates are REQUIRED to specify tag position.\nFor Reels: only username is used; x and y coordinates CANNOT be included.","properties":{"username":{"description":"Instagram username to tag (without @ symbol). Must be a public Instagram account.","examples":["instagram_handle","testuser"],"title":"Username","type":"string"},"x":{"description":"Horizontal position of the tag (0.0=left, 1.0=right). REQUIRED for images, CANNOT be used with Reels.","examples":[0.5],"maximum":1,"minimum":0,"title":"X","type":"number"},"y":{"description":"Vertical position of the tag (0.0=top, 1.0=bottom). REQUIRED for images, CANNOT be used with Reels.","examples":[0.5],"maximum":1,"minimum":0,"title":"Y","type":"number"}},"required":["username"],"title":"UserTag","type":"object"},"title":"User Tags","type":"array"},"video_file":{"description":"Local video file to upload. FileUploadable object where 'name' is the filename. The file will be uploaded to a temporary public URL for Instagram to fetch. At least one of: image_url, image_file, video_url, video_file, or children must be provided.","file_uploadable":true,"format":"path","title":"FileUploadable","type":"string"},"video_url":{"description":"MUST be a valid HTTP/HTTPS URL pointing to a publicly accessible video or Reel MP4 file. Must start with 'http://' or 'https://' (e.g., 'https://example.com/video.mp4'). IMPORTANT: URLs with query parameters (like AWS S3 signed URLs with authentication tokens) are NOT supported by Instagram and will be rejected. Use direct, publicly accessible URLs without query strings. DO NOT pass video descriptions or text - only actual URLs are accepted. At least one of: image_url, image_file, video_url, video_file, or children must be provided. When using video_url alone, media_type will be automatically set to 'REELS' if not specified.","examples":["https://example.com/video.mp4","https://cdn.example.com/videos/my-video.mp4"],"pattern":"^https?://","title":"Video Url","type":"string"}},"required":["ig_user_id"],"title":"PostIgUserMediaRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Rate limited to 25 API-published posts per 24-hour moving window. The publishing process: 1. First, create a media container using INSTAGRAM_CREATE_MEDIA_CONTAINER 2. Call this action with the creation_id - it will automatically poll for FINISHED status 3. Once ready, the media is published and the published media ID is returned For videos/reels, processing may take 30-120 seconds. Images are typically instant.","name":"INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH","parameters":{"properties":{"creation_id":{"description":"Container ID returned by INSTAGRAM_CREATE_MEDIA_CONTAINER (numeric string). This is NOT the same as ig_user_id. Do NOT pass bank account numbers or other non-Instagram identifiers.","examples":["17842618866645284"],"title":"Creation Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID (numeric string) or 'me' for the authenticated user. This ID is returned by INSTAGRAM_GET_USER_INFO or similar actions. Do NOT pass bank account numbers, connection IDs, or other non-Instagram identifiers.","examples":["17841405309211844","me"],"title":"Ig User Id","type":"string"},"max_wait_seconds":{"default":60,"description":"Maximum time in seconds to wait for the container to reach FINISHED status before publishing. Images are typically ready instantly, but videos/reels commonly take 30-120 seconds to process. WARNING: Setting this to 0 skips all status checks and attempts immediate publish, which will fail with error 9007 if the container is still processing (common for videos). Only use 0 if you are certain the container is already in FINISHED status (rare - typically only after manually checking via INSTAGRAM_GET_POST_STATUS). For videos/reels, use at least 60 seconds (default) or higher (up to 300).","maximum":300,"minimum":0,"title":"Max Wait Seconds","type":"integer"},"poll_interval_seconds":{"default":3,"description":"Interval in seconds between status checks while waiting for the container to be ready. Default is 3 seconds.","maximum":30,"minimum":1,"title":"Poll Interval Seconds","type":"number"}},"required":["ig_user_id","creation_id"],"title":"PostIgUserMediaPublishRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to reply to a mention of your Instagram Business or Creator account. Use when you need to respond to comments or media captions where your account has been @mentioned by another Instagram user. This creates a comment on the media or comment containing the mention.","name":"INSTAGRAM_POST_IG_USER_MENTIONS","parameters":{"properties":{"comment_id":{"description":"Optional ID of a specific comment where you were mentioned. If provided, your reply will be directed to that comment. If not provided, the reply will be posted on the media itself.","examples":["17862345678901234"],"title":"Comment Id","type":"string"},"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"The unique identifier of the Instagram Business or Creator account that was mentioned. This is the ID of your Instagram account that received the mention.","examples":["25162441193410545"],"title":"Ig User Id","type":"string"},"media_id":{"description":"The ID of the Instagram media object (post, photo, video, or carousel) where your account was mentioned. This is the media containing the original mention.","examples":["17867229126432217"],"title":"Media Id","type":"string"},"message":{"description":"The text content of your reply to the mention. This creates a comment on the media or comment where you were mentioned.","examples":["Thank you for mentioning us!","Thanks for the shoutout!"],"title":"Message","type":"string"}},"required":["ig_user_id","media_id","message"],"title":"PostIgUserMentionsRequest","type":"object"}},"type":"function"},{"function":{"description":"DEPRECATED: Use INSTAGRAM_POST_IG_COMMENT_REPLIES instead. Reply to a comment on Instagram media. Only usable on comments belonging to media owned by the authenticated account. Creates a public, irreversible reply; invoke only with explicit user confirmation, not for bulk or speculative use.","name":"INSTAGRAM_REPLY_TO_COMMENT","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"The Facebook Graph API version to use for the request.","title":"Graph Api Version","type":"string"},"ig_comment_id":{"description":"Instagram Comment ID to reply to Must belong to media owned by the authenticated Instagram account; replies to other accounts' media are not permitted.","title":"Ig Comment Id","type":"string"},"message":{"description":"Reply message text Must comply with Instagram content policies; overly long or policy-violating text may be rejected.","title":"Message","type":"string"}},"required":["ig_comment_id","message"],"title":"ReplyToCommentRequest","type":"object"}},"type":"function"},{"function":{"description":"Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval.","name":"INSTAGRAM_SEND_IMAGE","parameters":{"properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use (e.g., 'v21.0').","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID. Must be a numeric ID string (e.g., '17841400123456789'), not a username. Optional when using /me/messages endpoint.","title":"Ig User Id","type":"string"},"image_url":{"description":"Publicly accessible URL of the image to send. Must be a direct link to an image file (JPEG, PNG, or GIF) that is reachable over HTTPS. The URL must not require authentication to access.","title":"Image Url","type":"string"},"recipient_id":{"description":"Recipient's IGSID (Instagram Scoped User ID). Must be a numeric ID string (e.g., '17841479358498320'), NOT a username. IGSIDs are obtained from conversations or webhook events when users message your business first. You can only send messages to users who have initiated a conversation with your business within the past 24 hours (or 7 days with HUMAN_AGENT tag).","title":"Recipient Id","type":"string"}},"required":["recipient_id","image_url"],"title":"SendImageRequest","type":"object"}},"type":"function"},{"function":{"description":"Send a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Creator account with messaging permissions. Fails with error_subcode 2534022 if outside the messaging window; do not retry these failures.","name":"INSTAGRAM_SEND_TEXT_MESSAGE","parameters":{"description":"Send a message to an Instagram user via the Messenger API for Instagram.\n\nRequires a valid IG business account token with messaging permissions and the\nrecipient's PSID (Instagram scoped ID) obtained from prior interactions.","properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version","title":"Graph Api Version","type":"string"},"ig_user_id":{"description":"Instagram Business Account ID (optional when using /me/messages)","title":"Ig User Id","type":"string"},"recipient_id":{"description":"Recipient PSID (Instagram-scoped ID) Must be a real PSID obtained from INSTAGRAM_LIST_ALL_CONVERSATIONS or INSTAGRAM_LIST_ALL_MESSAGES — usernames or fabricated IDs cause HTTP 400 (code 100).","title":"Recipient Id","type":"string"},"reply_to_message_id":{"description":"Message ID (mid) to reply to. This creates a visual reply link to the original message in the conversation. The mid can be obtained from webhook events or previous API responses.","title":"Reply To Message Id","type":"string"},"text":{"description":"Message text to send","title":"Text","type":"string"}},"required":["recipient_id","text"],"title":"SendInstagramMessageRequest","type":"object"}},"type":"function"},{"function":{"description":"Tool to update the messenger profile settings for an Instagram account. Use when you need to configure ice breakers and messaging options. Ice breakers are suggested questions that help users start conversations with your Instagram Business account.","name":"INSTAGRAM_UPDATE_MESSENGER_PROFILE","parameters":{"description":"Request to update the messenger profile settings for an Instagram account.","properties":{"graph_api_version":{"default":"v21.0","description":"Instagram Graph API version to use. Defaults to v21.0.","title":"Graph Api Version","type":"string"},"ice_breakers":{"description":"Array of ice breaker objects to configure for the messenger profile. Ice breakers provide suggested questions to help users start conversations. Maximum 4 ice breakers allowed.","examples":[[{"payload":"HOURS_PAYLOAD","question":"What are your business hours?"},{"payload":"CONTACT_PAYLOAD","question":"How can I contact you?"}]],"items":{"description":"Ice breaker object for messenger profile.","properties":{"payload":{"description":"The payload data returned as a postback when the user selects this ice breaker. This can be used to trigger specific responses or actions in your messaging flow.","examples":["HOURS_PAYLOAD","CONTACT_PAYLOAD"],"title":"Payload","type":"string"},"question":{"description":"The question text displayed to users as an ice breaker prompt. This helps start conversations by providing suggested questions.","examples":["What are your business hours?","How can I contact you?"],"title":"Question","type":"string"}},"required":["question","payload"],"title":"IceBreaker","type":"object"},"title":"Ice Breakers","type":"array"},"ig_user_id":{"description":"Instagram Business Account ID whose messenger profile will be updated.","examples":["25162441193410545"],"title":"Ig User Id","type":"string"}},"required":["ig_user_id","ice_breakers"],"title":"UpdateMessengerProfileRequest","type":"object"}},"type":"function"}]}}}