list_accounts
List connected social accounts. Returns each account’s platform and handle.An agency client id (see
list_clients). When set, returns that client’s connected accounts instead of the team’s own.list_clients
List the agency clients under this team - each with itsid, name, and status. Pass a client id as the clientId argument to publish_post, list_accounts, or list_scheduled_posts to act on that client’s behalf instead of the team’s own accounts. No arguments.
get_platform_capabilities
Per-platform posting limits, formats, supported post types, and theoptions each platform accepts (names, types, limits).
generate_caption
Draft a caption in your brand voice.get_today_idea
Fetch today’s Muse content idea for the team - the daily, brand-grounded idea Sydium already generated. This is a read: it never generates a new idea or spends tokens. No arguments. Returns the current idea (topic, angle, format, hashtags, whyItFits, and an optional anchor - the one concrete detail to hang the post on), or null when none is in window. Paid plans see today’s idea; free plans see the idea for the current week.
add_media
Store an image or video in Sydium and return the media URL thatpublish_post and update_post require. Media must be Sydium-hosted - an external URL passed straight to publish_post is rejected - so call this first.
Pass either file (a file attached to the conversation) or url (a direct link to the image or video itself, not a web page containing it). Returns the media URL plus its measured size, dimensions and duration, and acceptedBy / rejectedBy - which platforms will take this file.
Supported: jpeg, png, gif, webp, mp4, mov, webm, up to 200MB. For a larger video, or a file on the user’s own computer, see create_upload_url. HEIC and AVIF (the iPhone photo defaults) are not supported - convert to JPEG first.
The media is removed once its post publishes, so a URL cannot be reused for a second post. Call add_media again.
A direct, publicly reachable link to an image or video file. Redirects are followed and each destination is re-validated.
A file the user attached to the conversation, supplied by the host as
{ download_url, file_id, mime_type?, file_name? }. Only hosts that support file parameters populate this - see the note below.The post type this media is for (
reel, story, carousel, short…). Story and carousel limits are stricter than the platform default, so without it acceptedBy is optimistic. Check rejectedBy before scheduling.File attachments are ChatGPT-only today. ChatGPT reads the tool’s file parameter declaration and passes attachments through, which is what makes drag-and-drop work - on the web client; ChatGPT mobile currently sends incomplete file references. Claude chat connectors have no equivalent mechanism, so there
url is the only path. If a user wants to post a file from their device and attaching it is not available, ask them for a public link - or, in an agent that runs on their computer (Claude Code), use create_upload_url.add_media is for real photos and videos. Do not generate or upload placeholder or text-only images to stand in for carousel slides - use draft_carousel.
create_upload_url
Upload a file from the user’s own computer. For agents that can run shell commands on that machine, such as Claude Code:add_media can only fetch a public link, and a file on the user’s disk has none. It is also the way in for a video over add_media’s 200MB limit - up to 2GB for video, 50MB for images.
Returns a one-time uploadUrl (valid for an hour) and the url to pass to publish_post or update_post. The agent PUTs the file’s bytes to uploadUrl with Content-Type set to exactly the returned contentType; the returned curl field is that command, with FILE standing for the path:
fileSize bytes. Unlike add_media, the file is not measured, so no acceptedBy / rejectedBy is returned; publish_post still checks the file exists before scheduling. The media is removed once its post publishes.
The file’s MIME type:
image/jpeg, image/png, image/gif, image/webp, video/mp4, video/quicktime (.mov) or video/webm.draft_carousel
Draft a carousel from slide text the agent writes. Sydium stores it as a draft and returnsopenUrl, a link that opens it in the Sydium composer. There the user sees the slides rendered in the brand’s carousel style and colors in the Carousel Studio, adjusts them, and schedules the post.
Nothing is published or scheduled. An agent cannot see a rendered slide, so a carousel is always approved by a person in Sydium. Give the user openUrl.
Returns draftId, openUrl, the number of slides, the platforms it is planned for, and status: "draft".
3-20 slides in reading order, each
{ headline, body?, altText? }. The first slide is the cover (a hook as the headline) and the last is the close (what to do next). Keep headlines short (up to 200 characters) and put the substance in body (up to 1000).Exactly two other cover hooks, different from the first slide’s headline and from each other. The user picks one of the three in the studio.
The platforms to plan it for (for example
instagram, linkedin, tiktok). Defaults to instagram. The composer opens with these selected.ISO 639-1 code. Omit unless the user asks for a specific language - the draft uses the brand voice’s language.
An agency client id (see
list_clients). The draft uses that client’s brand voice, and opening it switches Sydium to that client.The link opens in the workspace the connector was authorized for. A user signed in to a different workspace sees a “could not be opened” message - they switch workspace and open it again.
publish_post
Publish now, or schedule for later, to one or more platforms. Returns an operationid, a rollup status, and per-target results.
Up to 35 Sydium-hosted media URLs, as returned by
add_media. Arbitrary external URLs are rejected.A future timestamp with offset (for example
2026-07-01T09:00:00Z). Omit to publish immediately.1-10 targets, each
{ platform, postType?, caption?, options? }. postType is platform-specific (for example a YouTube short). See Per-platform options for options.An agency client id (see
list_clients). When set, the post publishes using that client’s connected accounts. Connectivity is checked against the client, not the team.Per-platform options
options uses the same names on every platform, never prefixed with the platform:
Plus each platform’s own, for example YouTube
category (the id as a string, "27" is Education), tags and visibility; TikTok privacyLevel and musicUsageConfirmed; Pinterest pinterestBoardId; Google Business ctaActionType and ctaUrl.
The complete list for each platform, with types and character limits, is options in get_platform_capabilities. An unknown option, a wrong type, or a text over its limit is refused with an error naming it (with the likely right name, for example “did you mean firstComment?”). Nothing is silently dropped or cut.
get_post_status
Per-target status of a publish or schedule operation, with the options each target will publish with (first comment, category, tags…) and the full caption.update_post
Edit a scheduled operation: change itscaption, media, and/or scheduleAt. Only targets that are still scheduled are updated - a target already publishing or published is left untouched, and the edit never races an in-flight publish. Omitted fields are left unchanged; media: [] clears media. You cannot change which platforms the operation posts to - cancel and re-create for that. Returns the operation’s state after the edit, or a 409 if no target is still scheduled.
Up to 35 Sydium-hosted media URLs from
add_media (same rules as publish_post). Pass [] to remove all media.Per-platform options to change, keyed by platform, for example
{"youtube": {"firstComment": "...", "category": "27"}}. Same names and the same refusals as publish_post. Merged into what the post already has; null clears an option.list_scheduled_posts
List the team’s upcoming scheduled posts. Each entry is one operation with its target platforms, scheduled time, and caption - so an agent can answer “what’s scheduled this week?” without knowing any ids. Thecaption is the post’s display text as shown in the app: the video title for YouTube, the caption for caption-first platforms. Published and failed posts are not included.
Window end. Pass
from and to together to bound a range, for example the current week.
