Skip to main content
ContentStudio logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 72
  • Triggers: 0
  • Slug: CONTENT_STUDIO
  • Version: 20261101_00

Tools

Slug: CONTENT_STUDIO_ADD_FACEBOOK_GROUP_ACCOUNTAdd a Facebook Group to a ContentStudio workspace through the manual connection flow. No browser authorization step is required.

Input Parameters

string
required
Facebook Group display name (3-255 characters).
string
Optional group image URL. Set to null or omit when no image is available.
string
required
Target workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_ADD_INBOX_NOTECreate an internal note on a ContentStudio Social Inbox conversation, optionally mentioning workspace users. This updates only the internal ContentStudio conversation record; it does not send a message or reply to an external social-network user.

Input Parameters

string
required
Internal note text visible to ContentStudio workspace users.
string
required
Connected account ID from List Social Accounts.
string
required
Workspace ID containing the Social Inbox conversation.
string ("facebook" | "instagram" | "linkedin" | "gmb" | "youtube")
required
Platform type of the Social Inbox conversation: facebook, instagram, linkedin, gmb, or youtube.
string
required
Social Inbox conversation reference to annotate.
string
Retry de-duplication key. Reuse the same key only when retrying the identical note creation request.
array
ContentStudio workspace user IDs to mention in the internal note.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_ADD_POST_COMMENTAdd a collaboration comment to a ContentStudio post, optionally mentioning workspace users. This updates ContentStudio’s internal post collaboration thread; it does not create an internal note or publish a Social Inbox reply.

Input Parameters

string
required
Text of the post collaboration comment.
string
required
ContentStudio post or plan ID to comment on.
string
required
Workspace ID containing the ContentStudio post.
array
Workspace user IDs to mention in the post collaboration comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_ADD_POST_NOTEAdd an internal note to a ContentStudio post. The note is for workspace collaboration; it does not mention users or publish a Social Inbox reply.

Input Parameters

string
required
Text of the internal note to add to the post.
string
required
ContentStudio post or plan ID to comment on.
string
required
Workspace ID containing the ContentStudio post.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_BULK_SET_INBOX_ELEMENTS_ARCHIVEDArchive or unarchive 1–100 ContentStudio Social Inbox elements in one provider batch. A batch may partially succeed; check the returned missing IDs.

Input Parameters

boolean
required
Set every selected element’s archive state.
array
required
Exactly 1-100 Social Inbox element references to update.
string
required
Workspace ID containing the Social Inbox elements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_BULK_SET_INBOX_ELEMENTS_STATUSSet the workflow status of 1–100 ContentStudio Social Inbox elements to done or pending in one provider batch. A batch may partially succeed; check the returned missing IDs.

Input Parameters

string ("done" | "pending")
required
Set every selected element’s workflow status to done or pending.
array
required
Exactly 1-100 Social Inbox element references to update.
string
required
Workspace ID containing the Social Inbox elements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CONNECT_BLUESKY_ACCOUNTConnect a Bluesky profile directly to a ContentStudio workspace using its handle and a Bluesky app password. The app password is sensitive, is sent only in this request, and is never returned.

Input Parameters

string
required
Bluesky handle to connect, such as name.bsky.social.
string
required
Sensitive Bluesky app password used only for this connection request. It is never returned by this tool.
string
required
Target ContentStudio workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CREATE_CAMPAIGNCreate a named, color-coded campaign in a ContentStudio workspace.

Input Parameters

string
required
Campaign name, up to 100 characters.
string ("color_1" | "color_2" | "color_3" | "color_4" | "color_5" | "color_6" | "color_7" | "color_8" | "color_9" | "color_10" | "color_11" | "color_12" | "color_13" | "color_14" | "color_15" | "color_16" | "color_17" | "color_18" | "color_19" | "color_20")
required
ContentStudio campaign color token.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CREATE_INBOX_TAGCreate a named, color-coded Social Inbox tag in a ContentStudio workspace.

Input Parameters

string
required
Name of the Social Inbox tag, up to 50 characters.
string
required
Social Inbox tag color as a six-digit hex value in #RRGGBB format.
string
required
Workspace ID in which to create the Social Inbox tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CREATE_LABELCreate a named, color-coded label in a ContentStudio workspace.

Input Parameters

string
required
Label name, up to 100 characters.
string ("color_1" | "color_2" | "color_3" | "color_4" | "color_5" | "color_6" | "color_7" | "color_8" | "color_9" | "color_10" | "color_11" | "color_12" | "color_13" | "color_14" | "color_15" | "color_16" | "color_17" | "color_18" | "color_19" | "color_20")
required
ContentStudio label color token.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CREATE_POSTCreate a draft, queued, content-category, or scheduled ContentStudio post with media, platform publishing, first-comment, label, campaign, and approval options. Queued, scheduled, and content-category posts can be published externally in the future.

Input Parameters

object
required
Complete ContentStudio post payload, preserving targeting, scheduling, media, platform options, organization, and approval configuration.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_CREATE_WORKSPACECreate a ContentStudio workspace with its required name, logo URL, and timezone.

Input Parameters

Public workspace logo URL.
string
required
Workspace name, up to 35 characters. ContentStudio rejects hyphens in workspace names; use letters, numbers, and spaces for portable names.
string
Optional workspace note.
string
required
IANA timezone for the workspace.
object
Workspace first day of week using the provider day/key pair.
string
Account owner ID. Required when the caller manages multiple super admins; optional for an account owner or caller linked to one super admin.
string ("api" | "mobile")
Instagram publishing method.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_CAMPAIGNPermanently delete a campaign from a ContentStudio workspace. Posts assigned to the campaign are detached from it.

Input Parameters

string
required
Campaign ID to permanently delete.
string
required
Workspace ID containing the campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_INBOX_COMMENTPermanently delete one public ContentStudio Social Inbox comment from its connected social platform. This destructive operation cannot be undone.

Input Parameters

string
required
Social Inbox comment ID to permanently delete.
string
LinkedIn comment URN. Required when platform_type is LinkedIn.
string
required
Connected social account ID associated with the comment.
string
required
Workspace ID containing the Social Inbox comment.
string ("facebook" | "instagram" | "linkedin" | "youtube")
required
Comment platform: facebook, instagram, linkedin, or youtube.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_INBOX_MESSAGESoft-delete one ContentStudio Social Inbox message from its connected platform account. The provider documents this as a destructive soft delete, not guaranteed permanent erasure.

Input Parameters

string
required
Social Inbox message ID to soft-delete.
string
required
Connected social account ID that owns the message.
string
required
Workspace ID containing the Social Inbox message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_INBOX_REVIEW_REPLYPermanently delete the business reply from one ContentStudio Social Inbox review. This does not delete the review itself.

Input Parameters

string
required
Social Inbox review reference whose business reply will be deleted.
string
required
Connected social account ID associated with the review.
string
required
Workspace ID containing the Social Inbox review.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_INBOX_TAGSPermanently delete one or more ContentStudio Social Inbox tags by ID. This destructive batch operation cannot be undone.

Input Parameters

array
required
One or more Social Inbox tag IDs to permanently delete.
string
required
Workspace ID containing the Social Inbox tags.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_LABELPermanently delete a label from a ContentStudio workspace.

Input Parameters

string
required
Label ID to permanently delete.
string
required
Workspace ID containing the label.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_POSTPermanently delete a ContentStudio post and optionally attempt deletion from selected or all social accounts where it was published. Returns every per-account outcome when social deletion only partially succeeds.

Input Parameters

string
required
Post ID to permanently delete.
array
Social account IDs to target for platform deletion. Omit to target all accounts on which the post was published.
string
required
Workspace ID containing the post.
boolean
Whether to attempt deletion from published social platforms before removing the ContentStudio post.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_DELETE_WORKSPACEPermanently delete a workspace and its workspace-scoped state.

Input Parameters

string
required
Workspace ID to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_AI_INSIGHTSGenerate AI analytics insights for one connected Facebook, GMB, Instagram, LinkedIn, Pinterest, TikTok, or YouTube account using one of seven fixed ContentStudio routes. First call CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and match the exact _id, workspace, and platform because a wrong platform_id can yield plausible empty or zero-filled success. limit caps this one response; the operation is not paginated.

Input Parameters

integer
Maximum number of insights for this single response. This is a result cap, not a page size or pagination control.
string
required
Inclusive analytics end date in YYYY-MM-DD format.
string
Response language as an ISO 639-1 code.
string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "youtube")
required
Connected-account platform used to select one of the seven documented AI-insights routes. Twitter has no AI-insights route.
string
IANA timezone used to interpret the analytics date range.
string
required
Inclusive analytics start date in YYYY-MM-DD format.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess: ContentStudio can return plausible empty or zero-filled success for an invalid or mismatched ID.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_ANALYTICS_SUMMARYReturn current-versus-previous summary KPIs for one connected Facebook, GMB, Instagram, LinkedIn, Pinterest, TikTok, Twitter, or YouTube account. First use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and match its _id, workspace, and platform; ContentStudio can return plausible zero metrics for an invalid account ID.

Input Parameters

string
Pinterest-only board ID used to restrict the summary to one board.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube")
required
Analytics platform. Must match the platform of the account selected with platform_id: facebook, gmb, instagram, linkedin, pinterest, tiktok, twitter, or youtube.
string
IANA timezone used to group analytics dates.
string
required
Inclusive start date in YYYY-MM-DD format.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for the same workspace and platform. Never guess; an invalid ID can return plausible zero-filled success.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_AUDIENCE_DEMOGRAPHICSReturn a supported Facebook, Instagram, LinkedIn, or YouTube audience demographics report through one of eight fixed ContentStudio routes. First use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and copy the exact _id for the same workspace and platform; a wrong platform_id may produce an empty or plausible success.

Input Parameters

string ("demographics" | "overview" | "location" | "top_geographies")
required
Report compatible with the selected platform. Facebook supports demographics, overview, and location; Instagram supports demographics and location; LinkedIn supports demographics; YouTube supports demographics and top_geographies.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "instagram" | "linkedin" | "youtube")
required
Connected-account platform: facebook, instagram, linkedin, or youtube.
string
IANA timezone used to group analytics dates.
string
Facebook-only date override in YYYY-MM-DD - YYYY-MM-DD format. It overrides start_date and end_date upstream.
string
required
Inclusive start date in YYYY-MM-DD format.
string
required
Exact account _id from CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess this value; ContentStudio may return an empty or plausible successful report for the wrong connected-account ID.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_AUDIENCE_GROWTH_ANALYTICSReturn audience, follower, or subscriber growth for one connected social account through an explicit platform, report, and granularity combination. First call CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and match its _id, workspace, and platform because an invalid account ID can produce plausible zero data.

Input Parameters

string ("audience_growth" | "follower_trend" | "subscriber_trend")
required
Growth report. Use audience_growth for Facebook, Instagram, or LinkedIn; follower_trend for Pinterest, TikTok, or Twitter; and subscriber_trend for YouTube.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube")
required
Connected-account platform: facebook, instagram, linkedin, pinterest, tiktok, twitter, or youtube.
string
IANA timezone used to group analytics dates.
string
Facebook audience_growth period-only override in YYYY-MM-DD - YYYY-MM-DD format. It overrides start_date and end_date upstream.
string
required
Inclusive start date in YYYY-MM-DD format.
string ("period" | "daily")
Report granularity. Daily is supported only for Pinterest follower_trend and YouTube subscriber_trend; all other combinations require period.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess: ContentStudio may return plausible zero-filled success for an invalid ID.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_CONTENT_ANALYTICSGet analytics for one platform-native Facebook, GMB, Instagram, LinkedIn, Pinterest, TikTok, Twitter, or YouTube content item. First use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS to obtain platform_id. Keep platform_id (the connected-account _id) distinct from content_id (the native content ID). Never guess platform_id because an invalid ID can return plausible empty or zero-filled success.

Input Parameters

string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube")
required
Platform of the content and connected account: facebook, gmb, instagram, linkedin, pinterest, tiktok, twitter, or youtube.
string
required
Platform-native post, pin, tweet, or video identifier in the provider’s documented format. This is sent as post_id and is not a ContentStudio connected-account ID.
string
required
ContentStudio connected-account _id. Use the exact _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. This is not the platform-native content ID. Never guess: an invalid ID can return plausible empty or zero-filled success.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_CURRENT_USERReturn the active ContentStudio user associated with the connected API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_ENGAGEMENT_ANALYTICSReturn active-user, impression, engagement, action, page-view, view, or watch-time analytics from one of 21 fixed ContentStudio routes. Use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS first and match its _id, workspace, and platform because an invalid account ID can return plausible zero metrics.

Input Parameters

string ("active_users" | "impressions" | "engagement" | "actions" | "page_views" | "engagement_impressions" | "views" | "watch_time")
required
Analytics report to retrieve. Period compatibility: Facebook active_users/impressions/engagement; GMB impressions/actions; Instagram active_users/impressions/engagement; LinkedIn page_views; Pinterest impressions/engagement; TikTok engagement; Twitter engagement_impressions; YouTube engagement/views/watch_time. Daily supports only Pinterest impressions/engagement and YouTube engagement/views/watch_time.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube")
required
Platform of the connected account selected with platform_id. Supported period reports: Facebook active_users/impressions/engagement; GMB impressions/actions; Instagram active_users/impressions/engagement; LinkedIn page_views; Pinterest impressions/engagement; TikTok engagement; Twitter engagement_impressions; YouTube engagement/views/watch_time.
string
IANA timezone used to group analytics dates.
string
Facebook-only date override in YYYY-MM-DD - YYYY-MM-DD format. It overrides start_date and end_date upstream.
string
required
Inclusive start date in YYYY-MM-DD format.
string ("period" | "daily")
Use period for the standard route or daily for a daily-delta route. Daily is supported only for Pinterest impressions/engagement and YouTube engagement/views/watch_time.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for the same workspace and platform. Never guess; an invalid ID can return plausible zero-filled success.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_GMB_ACTIVITY_ANALYTICSReturn Google Business Profile search-keyword, review, or media-activity analytics from one of exactly three documented routes. First call CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and use the exact _id whose platform is gmb; an invalid or non-GMB platform_id may produce plausible empty or zero-filled success. The optional limit caps search-keyword results only and does not paginate.

Input Parameters

integer
Maximum search keyword records to return (1-100). Valid only when report=search_keywords. This caps one response and is not a page size, offset, cursor, or instruction to paginate.
string ("search_keywords" | "reviews" | "media_activity")
required
GMB activity report to return: search_keywords, reviews, or media_activity. This selector chooses one of exactly three documented Google Business Profile analytics routes.
string
required
Inclusive report end date in YYYY-MM-DD format.
string
IANA timezone used to group report dates.
string
required
Inclusive report start date in YYYY-MM-DD format.
string
required
Exact Google Business Profile account/location _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace with platform=gmb. Never use an ID from another platform or guess this value: ContentStudio may return plausible empty or zero-filled HTTP 200 data for an invalid ID.
string
required
Workspace containing the connected Google Business Profile location.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_INBOX_CONTACTGet the contact profile associated with a ContentStudio Social Inbox element.

Input Parameters

string
required
Canonical element reference or provider element ID from Search Inbox Elements.
string
Connected account ID used to disambiguate a provider element ID shared across accounts.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_MEDIA_PERFORMANCE_ANALYTICSReturn Facebook reel/video, Instagram hashtag/story/reel, or LinkedIn hashtag performance through one of six fixed ContentStudio routes. First call CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and copy the exact _id for the same workspace and platform because a mismatched platform_id may produce plausible empty or zero data.

Input Parameters

string ("reels" | "video" | "hashtags" | "stories")
required
Media report supported by the selected platform. Facebook supports reels and video; Instagram supports hashtags, stories, and reels; LinkedIn supports hashtags.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "instagram" | "linkedin")
required
Platform of the connected account. It must match platform_id: ContentStudio can return plausible empty or zero-filled analytics for a mismatched account ID.
string
IANA timezone used to group analytics dates.
string
Facebook-only date override in YYYY-MM-DD - YYYY-MM-DD format. It overrides start_date and end_date upstream and is rejected for other platforms.
string
required
Inclusive start date in YYYY-MM-DD format.
string
required
Exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess or reuse an ID from another platform; an invalid ID may return plausible empty or zero-filled analytics.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_PUBLISHING_ANALYTICSReturn publishing behavior, posting cadence, pin rollups, YouTube discovery or sharing, or performance-schedule analytics from one of 12 documented routes. First call CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and match the exact _id, workspace, and platform because an invalid platform_id may produce plausible empty or zero data.

Input Parameters

string ("publishing_behavior" | "posts_per_day" | "pin_posting" | "pin_posting_daily" | "pin_rollup" | "find_video" | "video_sharing" | "performance_schedule")
required
Publishing report. Use publishing_behavior for Facebook, GMB, Instagram, LinkedIn, or TikTok; posts_per_day for LinkedIn; pin_posting, pin_posting_daily, or pin_rollup for Pinterest; find_video, video_sharing, or performance_schedule for YouTube.
string
required
Inclusive end date in YYYY-MM-DD format.
string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "youtube")
required
Connected-account platform. Report compatibility: Facebook, GMB, Instagram, and TikTok support publishing_behavior; LinkedIn supports publishing_behavior and posts_per_day; Pinterest supports pin_posting, pin_posting_daily, and pin_rollup; YouTube supports find_video, video_sharing, and performance_schedule.
string
IANA timezone used to group analytics dates.
string
Facebook publishing-behavior date override in YYYY-MM-DD - YYYY-MM-DD format. Unsupported by every other route.
string
required
Inclusive start date in YYYY-MM-DD format.
array
Optional publishing_behavior media filters. Facebook: text, link, images, videos, carousel, share, reels, others. Instagram: IMAGE, VIDEO, CAROUSEL_ALBUM, REELS, STORY. LinkedIn: text, images, videos, carousel, link, documents. Unsupported for all other platform/report combinations.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess: an invalid ID may return a plausible empty or zero-filled HTTP 200 success.
string
required
Workspace containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_GET_TWITTER_CREDITS_USEDReturn Twitter/X API credits consumed by one connected account over a date range. First use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and select the exact Twitter account _id in the same workspace; never guess the platform_id, because ContentStudio analytics can return plausible zero-filled success for an invalid ID.

Input Parameters

string
required
Inclusive end date in YYYY-MM-DD format.
string
IANA timezone used for the credit-usage date range.
string
required
Inclusive start date in YYYY-MM-DD format.
string
required
Use the exact Twitter account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace. Never guess; ContentStudio analytics can return plausible zero-filled success for an invalid platform_id.
string
required
Workspace containing the connected Twitter/X account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_INVITE_TEAM_MEMBERInvite a team or client member to a ContentStudio workspace with a role and the provider’s exact structured permission map. This immediately sends an invitation email to the member. Owner or admin access is required.

Input Parameters

string ("admin" | "approver" | "collaborator")
required
Workspace role to assign to the invited member.
string
required
Email address to invite to the workspace.
string ("team" | "client")
Membership class to assign to the invitee.
object
Optional exact permission map containing boolean capabilities and per-platform or content-category ID arrays.
string
required
Workspace ID to invite the member into.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_APPROVAL_WORKFLOWSList published approval workflows available in a ContentStudio workspace. Use a returned workflow_id when attaching an approval workflow while creating or updating a post.

Input Parameters

string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_CAMPAIGNSList or search campaigns in a ContentStudio workspace and return campaign IDs for post assignment. Returns one page and a cursor for continuation.

Input Parameters

Case-insensitive partial campaign-name search.
integer
Maximum campaigns to return in this page (1-100).
string
Cursor from the previous page; omit for the first page.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_CONNECTION_PLATFORMSList every social platform supported by ContentStudio account connection and identify whether each uses OAuth, credentials, or a manual flow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_CONTENT_CATEGORIESList or search workspace content categories and return category IDs usable when targeting posts; global categories are excluded. Returns one page and a cursor for continuation.

Input Parameters

integer
Maximum number of content categories to return in this page (1-100).
string
Cursor from a previous response; omit for the first page.
array
Category-name search terms. Multiple terms are sent as one comma-separated search filter.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_FACEBOOK_TEXT_BACKGROUNDSList every Facebook colored-text background preset ID usable in facebook_options on plain-text posts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_INBOX_CONVERSATION_CONTENTList messages, internal notes, or bookmarked messages for one ContentStudio Social Inbox conversation. Only messages support pagination and sorting.

Input Parameters

integer
Maximum messages to return (1-200). Valid only when content_type is messages.
string ("asc" | "desc")
Chronological message order. Valid only when content_type is messages.
string
Message-page cursor from a previous call. Valid only when content_type is messages.
string ("messages" | "notes" | "bookmarks")
required
Conversation content to list: messages, internal notes, or bookmarked messages.
string
required
Workspace ID from List Workspaces.
string
required
Social Inbox conversation reference from Search Inbox Elements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_INBOX_POST_COMMENTSList public Social Inbox comment threads for a platform post reference. ContentStudio treats an unknown post reference as a successful empty page, so items=[] and total=0 do not prove that the post exists.

Input Parameters

string
required
Platform post reference returned by a Social Inbox search.
integer
Maximum top-level comment threads to return in this page (1-200).
string
Cursor from a previous response; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_INBOX_TAGSList all Social Inbox tags in a ContentStudio workspace.

Input Parameters

string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_LABELSList or search labels in a ContentStudio workspace. Returned label_id values can be used to assign labels when creating or updating posts.

Input Parameters

string
Case-insensitive partial label-name search.
integer
Maximum number of labels to return in this page (1-100).
string
Cursor from a previous response; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_MEDIAList and filter media-library assets in a ContentStudio workspace. Returns one page with media IDs usable when creating or updating posts.

Input Parameters

string ("recent" | "oldest" | "size" | "a2z" | "z2a")
Media sort order: recent, oldest, size, a2z, or z2a.
string
Case-insensitive partial media-name search (maximum 255 characters).
integer
Maximum number of media assets to return in this page (1-100).
string ("images" | "videos")
Media type to include: images or videos.
string
Cursor from a previous response; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_POST_COMMENTSList collaboration comments and internal notes on a ContentStudio post. Returns one page and a cursor for continuation.

Input Parameters

string
required
ContentStudio post ID whose collaboration comments to list.
integer
Maximum comments to return in this page (1-100).
string
Cursor from the previous page; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_POSTSList ContentStudio workspace posts using status, date, approval, label, campaign, content-category, creator, and comment-state filters. Returns one page and a cursor for continuation.

Input Parameters

string
Latest post date to include, in YYYY-MM-DD format.
array
Post statuses to include. Multiple values are sent as repeated status[] filters.
string
Earliest post date to include, in YYYY-MM-DD format.
array
Label IDs to filter posts by.
integer
Maximum posts to return in this page (1-100).
array
User IDs that created the posts.
string
Cursor from the previous page; omit for the first page.
array
Campaign or folder IDs to filter posts by.
string
required
Workspace ID from List Workspaces.
string ("resolved" | "unresolved" | "all")
Comment resolution state to include; all does not restrict comment state.
array
Approver user IDs. Returns posts assigned to any of these approvers.
array
Content category IDs to filter posts by.
array
User IDs that requested approval. Returns posts submitted by these users.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_RANKED_CONTENT_ANALYTICSList one offset-paginated page of top, least-performing, sorted, or pin-performance content analytics for a connected account. YouTube top and least results combine parallel view- and engagement-ranked arrays in the items list; the original arrays are retained in metadata.

Input Parameters

string ("top" | "sorted_top" | "least" | "pin_performance")
required
Ranking route. Facebook/Instagram/LinkedIn: top or sorted_top; GMB: top; Pinterest: top or pin_performance; TikTok: top or sorted_top; Twitter: top or least; YouTube: top, least, or sorted_top.
string
required
Inclusive analytics end date in YYYY-MM-DD format.
array
Hashtag filters for Instagram or LinkedIn sorted-top content.
string ("post_engagement" | "created_time" | "comments" | "shares" | "post_clicks" | "post_impressions" | "post_impressions_unique" | "post_video_views" | "total" | "like_count" | "comments_count" | "saved" | "reach" | "impressions" | "views" | "post_created_at" | "favorites" | "repost" | "created_at" | "reply_count" | "quote_count" | "retweet_count" | "impression_count" | "bookmark_count" | "likes" | "dislikes" | "engagement" | "engagement_rate" | "minutes_watched" | "published_at")
Ordering metric for Facebook/Instagram/LinkedIn top or sorted_top, Twitter top, or YouTube sorted_top. Values are route-specific and validated. Do not use for TikTok; use ranking_metric instead.
string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube")
required
Connected-account platform. Ranking compatibility: Facebook, Instagram, and LinkedIn support top and sorted_top; GMB supports top; Pinterest supports top and pin_performance; TikTok supports top and sorted_top; Twitter supports top and least; YouTube supports top, least, and sorted_top.
string
IANA timezone used to interpret and group analytics dates.
integer
Maximum ranked items to return in this page (1-100).
string
Facebook-only YYYY-MM-DD - YYYY-MM-DD date override sent as date.
string
required
Inclusive analytics start date in YYYY-MM-DD format.
array
Optional media filters. Facebook top: text, link, images, videos, carousel, share, reels, others; Facebook sorted_top also accepts documented media strings; Instagram top/sorted_top: IMAGE, VIDEO, CAROUSEL_ALBUM, REELS, STORY; LinkedIn top/sorted_top: text, images, videos, carousel, link, poll; YouTube top/least/sorted_top: video, short. Pinterest top and pin_performance accept documented media strings such as IMAGE and VIDEO.
string
Non-negative offset cursor returned by the previous page; omit for the first page.
string
required
Use the exact account _id returned by CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS for this workspace and platform. Never guess: ContentStudio can return a plausible successful empty or zero-filled response for an invalid ID.
array
GMB STANDARD, OFFER, or EVENT topic filters sent upstream as topic_type.
array
Twitter tweet-type filters sent upstream as tweet_type.
array
Instagram FEED, REELS, or STORY entity filters.
string
required
Workspace containing the connected social account.
string ("post_engagement" | "engagements_count" | "likes_count" | "comments_count" | "shares_count" | "views_count" | "created_time")
TikTok sorted_top ranking metric: post_engagement, engagements_count, likes_count, comments_count, shares_count, views_count, or created_time. Sent to ContentStudio as sort_order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTSList one page of connected social accounts in a ContentStudio workspace, with optional platform and name filters. Returns a cursor for continuation; account identifiers can be used for applicable analytics and Social Inbox calls.

Input Parameters

string
Case-insensitive account-name search.
integer
Maximum number of social accounts to return in this page (1-100).
array
Social platforms to include. Multiple values are sent as one comma-separated platform filter.
string
Cursor from a previous response; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_TEAM_MEMBERSList or search team members in a ContentStudio workspace, returning available user and membership IDs, roles, memberships, and permissions. Returns one page and a cursor for continuation.

Input Parameters

string
Name or email search term.
integer
Maximum team members to return in this page (1-100).
string
Cursor from the previous page; omit for the first page.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_LIST_WORKSPACESList workspaces accessible to the connected account and return workspace IDs for workspace-scoped tools. Returns one page and a cursor for continuation.

Input Parameters

integer
Maximum workspaces to return in this page (1-100).
string
Cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_MARK_INBOX_ELEMENT_READMark one ContentStudio Social Inbox element as read. Calling this for an already-read element is a successful no-op; this tool cannot mark it unread.

Input Parameters

string
required
Social Inbox element reference to mark as read.
string
required
Workspace ID containing the Social Inbox element.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_MERGE_INBOX_TAGSIrreversibly replace at least two ContentStudio Social Inbox source tags with one tag using the requested name and color. The source tags are not retained as separate tags, and this operation cannot be undone.

Input Parameters

array
required
IDs of at least two source tags to replace. The merge removes these source tags as distinct tags and cannot be undone.
string
required
Name for the replacement tag created by the merge.
string
required
Color for the replacement tag created by the merge, as a six-digit hex value in #RRGGBB format.
string
required
Workspace ID containing the Social Inbox source tags.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_REMOVE_SOCIAL_ACCOUNTDisconnect a social account from a ContentStudio workspace. The connected user must have the workspace’s save_social permission.

Input Parameters

string
required
Connected account _id from List Social Accounts.
string
required
Workspace ID containing the connected social account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_REMOVE_TEAM_MEMBERPermanently remove a member from a ContentStudio workspace. Owner or admin access is required. If approval workflows or in-flight posts reference the member, retry with confirmed=true only after reviewing those dependencies.

Input Parameters

boolean
Whether to confirm removal when this member is referenced by approval workflows or in-flight posts. Leave false first to preserve the provider’s dependency guard; set true only after reviewing a REQUIRES_REMOVAL_CONFIRMATION response.
string
required
Membership ID from List Team Members, not the user’s account ID.
string
required
Workspace ID containing the member.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_REPLY_TO_INBOX_REVIEWPublish a public business reply to a Google Business Profile review in ContentStudio Social Inbox, replacing its existing reply when one exists. This sends the reply externally.

Input Parameters

string
required
Review reference returned by Social Inbox search.
string
required
Connected social account ID associated with the review.
string
required
Public business reply to publish. This immediately creates or replaces the existing external review reply.
string
required
Workspace ID containing the Social Inbox review.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_REVIEW_POST_APPROVALApprove or reject a ContentStudio post that is under review, optionally recording a review comment. This decision can advance or end the post’s approval workflow and cannot be treated as a reversible edit.

Input Parameters

string ("approve" | "reject")
required
Approval decision to record for the post.
string
Optional comment explaining the approval or rejection.
string
required
Post ID to approve or reject.
string
required
Workspace ID containing the post awaiting review.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SEARCH_INBOX_ELEMENTSSearch one page of ContentStudio Social Inbox conversations, posts, and reviews using status, text, tag, channel, and targeted-element filters.

Input Parameters

array
Tag IDs to require on returned Inbox elements.
string ("all" | "marked_done" | "archived" | "assigned")
Status filter: all, marked_done, archived, or assigned.
integer
Maximum Inbox elements to return in this page (1-200).
array
Inbox element types to include: conversation, post, or review.
string
Cursor from a previous response; omit for the first page.
string
Text to search for across Social Inbox elements.
object
Social platform names mapped to the account IDs to search.
string
required
Workspace ID from List Workspaces.
string
Specific Inbox element reference to target when narrowing the search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SEND_INBOX_COMMENTPublish a public comment or reply on a ContentStudio Social Inbox post. This immediately causes an irreversible external send; it never sends a private message.

Input Parameters

string
Text to send. Provide message, attachment_file, or both; at least one is required.
string
required
Platform post reference from Inbox search.
string
Parent comment ID when publishing a public reply to a specific comment.
string
required
Connected account ID from List Social Accounts.
string
required
Workspace ID.
string
required
Platform type of the public Social Inbox post.
object
A file the caller hands IN. s3key is an S3/R2 reference (production) or a base64 data: URL (self-hosted FILE_BACKEND=base64) — the FileStore knows which. Mirrors mercury/tools/files.py field-for-field.
string
Retry de-duplication key. Reuse it for sequential retries of the same send; concurrent duplicate sends may both be delivered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SEND_INBOX_MESSAGESend a Facebook or Instagram direct message through ContentStudio Social Inbox, optionally with one image or video attachment. Delivery is an irreversible external side effect. An Idempotency-Key protects sequential retries, but concurrent duplicate sends may both be delivered.

Input Parameters

object
A file the caller hands IN. s3key is an S3/R2 reference (production) or a base64 data: URL (self-hosted FILE_BACKEND=base64) — the FileStore knows which. Mirrors mercury/tools/files.py field-for-field.
string
Message text. Provide message, file, or both.
string ("image" | "video")
Attachment type: image or video. Required with file and invalid without file.
string
required
Connected account ID from List Social Accounts.
string
required
Workspace ID.
string ("facebook" | "instagram")
required
Conversation platform: facebook or instagram.
string
required
Social Inbox conversation reference to message.
string
Retry de-duplication key. Reuse it only for sequential retries of the same send; concurrent duplicate requests may both be delivered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SEND_INBOX_PRIVATE_REPLYSend a Facebook private reply from a ContentStudio Social Inbox post as a private message, optionally with an attachment. This immediately causes an irreversible external send and never publishes a public comment.

Input Parameters

string
Private Facebook message text. Provide message, attachment_file, or both; at least one is required.
string
required
Platform post reference from Inbox search.
string
required
Connected account ID from List Social Accounts.
string
required
Workspace ID.
object
A file the caller hands IN. s3key is an S3/R2 reference (production) or a base64 data: URL (self-hosted FILE_BACKEND=base64) — the FileStore knows which. Mirrors mercury/tools/files.py field-for-field.
string
Retry de-duplication key. Reuse it for sequential retries of the same send; concurrent duplicate sends may both be delivered.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SET_INBOX_COMMENT_HIDDENHide or unhide one ContentStudio Social Inbox comment.

Input Parameters

boolean
required
Strict boolean: true hides the comment; false unhides it.
string
required
Social Inbox comment ID whose hidden state will change.
string
Connected social account ID from List Social Accounts. Required only when unhiding the comment.
string
required
Workspace ID containing the Social Inbox comment.
string ("facebook" | "instagram")
Comment platform, facebook or instagram. Required only when unhiding the comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SET_INBOX_COMMENT_LIKEDLike or unlike one Facebook comment in the ContentStudio Social Inbox on behalf of the connected Page.

Input Parameters

boolean
required
Strict boolean: true likes the comment; false unlikes it.
string
required
Social Inbox comment ID whose liked state will change.
string
required
Workspace ID containing the Social Inbox comment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SET_INBOX_MESSAGE_BOOKMARKEDBookmark or unbookmark one ContentStudio Social Inbox message.

Input Parameters

boolean
required
Strict boolean: true bookmarks the message; false unbookmarks it.
string
required
Social Inbox message ID whose bookmarked state will change.
string
required
Workspace ID containing the Social Inbox message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_SUMMARIZE_INBOX_ELEMENTSCount ContentStudio Social Inbox conversations, posts, and reviews by all, unassigned, mine, assigned, marked-done, and archived states, optionally filtering by element type and social channel.

Input Parameters

array
Social Inbox element types to include in the counts.
object
Social platform names mapped to the connected account IDs to include.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_CAMPAIGNUpdate a campaign’s name or color.

Input Parameters

string
New campaign name.
string ("color_1" | "color_2" | "color_3" | "color_4" | "color_5" | "color_6" | "color_7" | "color_8" | "color_9" | "color_10" | "color_11" | "color_12" | "color_13" | "color_14" | "color_15" | "color_16" | "color_17" | "color_18" | "color_19" | "color_20")
New color token.
string
required
Campaign ID from List Campaigns.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_INBOX_CONTACTPartially update the name, email, phone, or company of the contact associated with a ContentStudio Social Inbox element. The update applies to every element for that contact on the specified connected account in the workspace.

Input Parameters

string
New contact name; omit to preserve it.
string
New contact email address; omit to preserve it.
string
New contact phone number; omit to preserve it.
string
New contact company; omit to preserve it.
string
required
Canonical Social Inbox element reference or provider element ID.
string
required
Required ContentStudio connected-account ID from List Social Accounts. It disambiguates provider element IDs that exist under multiple accounts.
string
required
Workspace ID containing the Social Inbox element.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_INBOX_ELEMENT_TAGSAdd one or more tags to a ContentStudio Inbox element or remove one tag from it.

Input Parameters

string
Single tag ID to remove. Required only when operation is remove.
array
Non-empty tag ID list to add. Required only when operation is add.
string ("add" | "remove")
required
Tag update to perform: add one or more tags, or remove one tag.
string ("conversation" | "post" | "review")
required
Inbox element type: conversation, post, or review.
string
required
Social Inbox element reference from Search Inbox Elements.
string
required
Connected social account ID that owns the Inbox element.
string
required
Workspace ID containing the Social Inbox element.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_INBOX_TAGUpdate a ContentStudio Social Inbox tag’s name or color.

Input Parameters

string
required
Social Inbox tag ID to update.
string
New tag name.
string
New tag color as a six-digit hex value in #RRGGBB format.
string
required
Workspace ID containing the Social Inbox tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_LABELUpdate a label’s name or color.

Input Parameters

string
New label name.
string ("color_1" | "color_2" | "color_3" | "color_4" | "color_5" | "color_6" | "color_7" | "color_8" | "color_9" | "color_10" | "color_11" | "color_12" | "color_13" | "color_14" | "color_15" | "color_16" | "color_17" | "color_18" | "color_19" | "color_20")
New color token.
string
required
Label ID from List Labels.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_POSTFully replace an unpublished post’s content, accounts, scheduling, platform options, labels, campaign, and approval configuration. Also attach, restart, resume, renotify, keep, or remove an existing approval workflow. Setting the post to queued, scheduled, or content-category can cause future external publication.

Input Parameters

object
required
Complete replacement payload. Omitted optional fields are removed or reset according to ContentStudio’s full-replacement behavior.
string
required
Unpublished post ID from List Posts.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_TEAM_MEMBERReplace a workspace member’s role and complete permission map, and optionally replace their team or client membership class. Requires workspace owner or administrator access.

Input Parameters

string ("admin" | "approver" | "collaborator")
required
Replacement workspace role.
string
required
Membership ID from List Team Members, not the underlying user ID.
string ("team" | "client")
Replacement membership class; omit when it should not change.
object
required
Complete replacement permission map. Documented flags and account-ID arrays are validated; additional ContentStudio permission keys are preserved.
string
required
Workspace ID from List Workspaces.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPDATE_WORKSPACEUpdate selected settings of an existing workspace.

Input Parameters

string
New public logo URL; omit to leave unchanged.
string
New workspace name; omit to leave unchanged. ContentStudio rejects hyphens in workspace names; use letters, numbers, and spaces for portable names.
string
New workspace note. Set to null to clear the note, or omit to leave it unchanged.
string
New IANA timezone; omit to leave unchanged.
object
New first-day provider pair; omit to leave unchanged.
string
required
Workspace ID from List Workspaces.
string ("api" | "mobile")
Instagram publishing method; omit to leave unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTENT_STUDIO_UPLOAD_MEDIAUpload one media file or import one public media URL into a ContentStudio workspace media library.

Input Parameters

string
Public media URL to import. Provide this or file, but not both.
object
A file the caller hands IN. s3key is an S3/R2 reference (production) or a base64 data: URL (self-hosted FILE_BACKEND=base64) — the FileStore knows which. Mirrors mercury/tools/files.py field-for-field.
string
Destination media-library folder ID, when applicable.
string
required
Workspace ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not