ContentStudio

List media assets (images, videos, GIFs) from a workspace's media library. Returns a paginated flat list (Laravel paginator metadata + a `data` array). Each media asset uses `id`. Use this to find media IDs/URLs to attach to posts. All filters are optional.

fetch_media

Best time to post: analyses the historical engagement of a workspace's connected accounts and returns the highest-scoring posting times, both pooled across accounts (global) and per account (individual). A "slot" is one recommended posting time — a weekday and an hour (e.g. Wednesday 14 = 2 PM on Wednesdays), not a specific date. Slots come back ranked best-first. The slot counts below only decide how many ranked results to return; they never change the analysis. Omit `entities` to analyse every connected account — that is the usual call. Times are always returned in the workspace timezone, echoed back as `meta.timezone` — there is no timezone parameter. Use this before create_post to pick a schedule time.

fetch_optimal_times

List comments on a post with pagination.

fetch_comments

List posts in a workspace with optional filters. Results include post content, publishing details, and privacy-minimized approval information when available.

fetch_posts

Get workspace social accounts with optional platform filter and pagination

fetch_social_accounts

Get user workspaces with pagination

fetch_workspaces

List the Facebook colored-background presets available for text-only posts. Call this before create_post when the user asks for a "colored background", "red background", "gradient background", etc. on a Facebook post. Pick a preset whose description matches the user's intent and pass its `id` as `facebook_background_id` to create_post. Each preset has: id, type (solid/gradient/image), background_color (CSS value), color (text color), description, category. ⚠️ Backgrounds only apply to plain text posts — if images or video are attached, create_post will reject the request.

list_facebook_text_backgrounds

Responds with pong

ping

Update an existing post by replacing its editable post body. The request uses the create_post body fields plus post_id. Posts with published or processing status cannot be updated; the API returns a validation error for those states. Approval configuration supports either the legacy approvers fields or approval_workflow. The workflow object accepts workflow_id when attaching a workflow, or workflow_action when acting on an existing workflow. These fields are mutually exclusive. The response contains the post id, an optional post URL, and an optional warning.

update_post

Check whether the connected ContentStudio account is authenticated. Returns only authentication status.

validate_token