Multi Upload Tool

Status of an upload link from create_media_upload: waiting (the user has not finished), ready (with mediaUrls to pass to create_post), or expired (create a new link). Read-only.

Read one search result in full, by the id search returned (post: or account:): a post's caption, status, schedule or publication time and platform URL, or an account's details. Read-only.

Read published-post performance: views, likes, comments, shares, plus growth over the last 30 days. summary compares the last 30 days with the 30 before (views gained, follower change, posts published; null = not measured, never 0) and followerHistory gives one follower total per day. Call with no argument for every account at once, with accountId for one account, or with postId for a single post. Numbers come from a nightly sync, so they lag the platform by up to a day — lastRefreshedAt says when they were last measured, and a metric a platform does not report comes back as 0. Account and global calls also return bestTimes: the weekday and hours whose posts averaged the most views, to feed scheduledAt in create_post. This is read-only; it never publishes.

Return the hashtags this user has used most often in their recent posts on the given platform, plus platform-specific guidance and (for Instagram) the list of hashtags that would cause the post to be rejected. Does NOT generate new hashtags — use your own creative ability for that; this tool gives you the user's historical preferences which you cannot see otherwise.

Return the character limits, daily post cap, supported media types, and required platformSettings schema for a given platform. Call this before create_post to ensure inputs are valid.

Get the current status of one post. Returns status (pending | processing | completed | scheduled | failed), the full caption, the platform's videoUrl once published, and on failure errorMessage plus failure: { code, retryable, nextAction } (see retry_post).

How many more posts an account can publish today before hitting the platform's daily cap, and when the count resets. For an X account it also returns xCredits (balance, cost per post: 1, or 15 with a link, and the packs): an X post fails without enough credits. Check it before a batch of create_post calls. Read-only.

List the social media accounts connected to the authenticated user (or current team workspace). Returns id, platform, accountName, status, tags and lastUsedAt. Call this first to discover which accountIds can be used in create_post. Workspaces can hold many accounts: narrow with platform, tag or search instead of reading the whole list. Only accounts with status 'active' can publish.

List the upload pools: queues of videos drip-fed to accounts on recurring weekly slots (time, days, accounts), with how many items are queued. Requires a plan with upload pools. Read-only.

List recent posts published, scheduled, or failed by the authenticated user. Useful to avoid duplicates, reference past content, or audit failures. Captions are cut to 200 characters — call get_post_status for the full text. hasMore: true means older posts exist beyond this page; narrow with accountId, platform or status rather than raising limit.

Search your posts (caption and title) and connected accounts by keyword. Returns { results: [{ id, title, url }] }; pass an id to fetch for the full record. Read-only.

Dry run of create_post: takes the same arguments and runs the same checks (account status, plan, daily caps, monthly quota, queue room, caption and title limits, required platformSettings, scheduling window) without publishing anything. Call it before create_post on any batch, or whenever unsure — a post rejected here would otherwise fail later, sometimes hours later for scheduled posts. mediaUrls are not downloaded: file format, size and duration are only checked when the post is actually published.

Returns: { valid, errors: [{ accountId, platform, error }], targets: [{ accountId, platform, scheduledFor }] }. An error with accountId null applies to the whole batch.