AutoPoster AI

Creates a short-lived link where the user can upload images from their device into the Auto Poster media library. Use this when the user wants to attach an image that exists only in the chat or on their device (no public URL) and your client cannot send file contents. Give the link to the user, wait until they say the upload is done, then call autoposter_list_media (newest first) and attach the image with mediaIds in autoposter_draft_post or autoposter_schedule_post.

Deletes or cancels a draft, scheduled, or pending post by ID.

Creates a draft post for human review. If API key lacks direct publish, post is saved as pending_approval and notifications are sent to workspace approvers. Accepts mediaUrls (public URLs) or files (client-supplied file objects up to 100MB). For large video files over 100MB, tell the user to provide a direct public file URL or use autoposter_get_media_upload_url.

Reads performance analytics. level 'posts' (default) returns per-post metrics (impressions, views, likes, comments, shares, clicks, ...) with totals for a date range or for one post. level 'accounts' returns the latest account-level snapshot (followers, reach, impressions, engagement, ...) per connected account, plus a daily series when from/to are given. Data is synced periodically, so very recent posts may have no metrics yet.

Only for clients that can perform an HTTP PUT or multipart POST (not chat-only clients such as Gemini): if you cannot make that request yourself, use autoposter_create_upload_link instead. Generates a presigned S3 upload URL for direct, high-speed upload of videos or images up to 5GB without size limits or timeouts. Returns direct PUT url, POST upload fields, and public CDN URL.

Retrieves a single post by ID including its state (drafts, pending_approval, queued, posted) and live link receipts.

Checks delivery status of a post and returns live platform links/receipts once published.

Returns platform publishing constraints including character limits, media format requirements, and guidelines.

Lists all connected social media accounts (LinkedIn, X (Twitter), Instagram, TikTok, YouTube, Threads, Bluesky, Pinterest, Facebook, Telegram) in the current Autoposter workspace.

Lists media files (images and videos) stored in the workspace media library with public CDN URLs.

Lists posts in the workspace. Supports filtering by state ('drafts', 'scheduled', 'queued', 'posted', 'failed', 'pending_approval'), caption text search, and limit.

Approves and immediately publishes an existing draft or pending post. Requires an API key with direct publish permission.

Schedules a post for a future date/time. Automatically converts local time using workspace/user timezone into UTC. Accepts mediaUrls (public URLs) or files (client-supplied file objects up to 100MB). For large video files over 100MB, tell the user to provide a direct public file URL or use autoposter_get_media_upload_url.

Edits an existing draft, scheduled, pending_approval or declined post in place: text, title, visibility, media, first comment / thread, or schedule time. Only the fields you pass change. Posts already published or being processed cannot be edited. If the API key cannot publish directly, an edited scheduled post goes back to pending_approval.

Uploads an image or video to Auto Poster media library. Accepts a file object supplied by the client, a public image or video URL, a data URI, or base64 data. Direct chat download limit is 100MB. For larger videos or files (>100MB), tell the user to provide a direct public file URL or use autoposter_get_media_upload_url for direct S3 upload up to 5GB. If the image exists only in the chat or on the user's device and cannot be sent here, use autoposter_create_upload_link instead.

Return the profile represented by this request's authenticated credentials. The opaque id is unique within this app and remains unchanged across token refresh, reconnection, and display-metadata changes.