account_capabilities
ChatGPTGet publish capabilities and provider rules for connected accounts: what media is allowed, text limits, and whether publishing is currently possible. Pass accountId for one account, or provider to filter, or neither for all.
apply_schedule
ChatGPTCreate a publishing run from a schedule document. Posts are scheduled or published through connected accounts. Send an idempotencyKey so retries do not create duplicate runs.
cancel_post
ChatGPTCancel a scheduled post before it publishes.
connect_account
ChatGPTStart connecting one of the user's own social accounts to their SocialClaw workspace. For most providers this returns an authorizeUrl; give it to the user so they sign in with the provider themselves (SocialClaw never sees their password). Telegram and Discord have no sign-in page: Telegram takes the bot token and chat id of a bot the user created and made admin of their channel, and Discord takes a webhook URL the user created for their channel. Only pass values the user gave you for this purpose.
get_analytics
ChatGPTGet analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
get_asset
ChatGPTGet one media asset from the user's SocialClaw library by id, including its status (uploading, ready, or failed), import progress, and publicUrl. Use it after upload_asset returns status uploading, until the asset is ready.
get_instagram_account_insights
ChatGPTGet an Instagram account's insight trend (a daily time series, e.g. reach) over the last N days.
get_instagram_media_insights
ChatGPTGet analytics for one Instagram post (reach, likes, comments, saved, shares, views). Use list_instagram_media for the mediaId.
get_instagram_messages
ChatGPTRead the messages in an Instagram direct-message conversation.
get_instagram_profile
ChatGPTGet an Instagram account's profile stats: followers, follows, media count, bio.
get_post
ChatGPTGet one post including its delivery state and provider identifiers.
get_profile
ChatGPTIdentify the connected SocialClaw workspace: its stable id, name, and plan. Use it to confirm which workspace you are acting on.
list_accounts
ChatGPTList connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, threads, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress).
list_assets
ChatGPTList media (images/videos) the user has uploaded to their SocialClaw library, newest first. Each asset includes a publicUrl usable directly as media_link in validate_schedule/apply_schedule. Use this to find a previously uploaded file (e.g. from the dashboard) to post. Optionally filter by kind (image/video), mime, or a text query over filename/id.
list_instagram_conversations
ChatGPTList the Instagram direct-message conversations for an account, most recent first. Each conversation includes counterpart (the other person's {id, username}) — use its id as the recipientId when replying; participants also lists the account itself.
list_instagram_media
ChatGPTList an Instagram account's recent posts (caption, permalink, timestamp, comment count) so you can find one to read or moderate comments on. account is the connected-account id or handle.
list_instagram_mentions
ChatGPTList recent @mentions of the workspace's Instagram accounts (captured from Instagram mention webhooks).
list_posts
ChatGPTList posts in the workspace with optional filters.
post_attempts
ChatGPTList publish attempts for a post, including provider errors. Use this to debug failed posts.
preview_campaign
ChatGPTPreview how a campaign schedule document expands into concrete posts and steps without creating anything.
publish_draft
ChatGPTPublish a previously created draft run, optionally at a given ISO-8601 start time.
react_instagram_message
ChatGPTReact to a received Instagram direct message (e.g. love).
refresh_analytics
ChatGPTFetch fresh analytics for a published post from the provider and store a new snapshot, then return it. Supported providers: Instagram, TikTok, YouTube, Reddit, X, Pinterest, Snapchat (others return an unsupported snapshot). Call this before get_analytics when you need current numbers rather than the last stored snapshot.
retry_post
ChatGPTRetry a failed post.
run_status
ChatGPTGet the status summary of a publishing run and its posts.
send_instagram_message
ChatGPTSend an Instagram direct message — a text reply, or an image/video attachment via attachment_url. Only allowed within 24 hours of the recipient's last message unless a message tag (e.g. HUMAN_AGENT) is supplied.
upload_asset
ChatGPTAdd an image or video to the user's SocialClaw media library so it can be attached to a post. Pass exactly one of: file (a file the user attached in this chat), sourceUrl (a direct public http(s) link to the image or video file, not a web page), or contentBase64 (small files only). Files up to 1 GB are supported through file or sourceUrl. The result is the asset: when status is ready, use its publicUrl as media_link in validate_schedule/apply_schedule. Large videos may come back with status uploading; then call get_asset with the asset id until status is ready (or failed) before scheduling.
validate_schedule
ChatGPTValidate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
workspace_health
ChatGPTGet workspace health, including connection state across providers. Pass provider to check one provider's connections.
workspace_usage
ChatGPTGet workspace usage counters and plan entitlement consumption.