---
canonical_url: "https://docs.composio.dev/toolkits/content_studio"
markdown_url: "https://docs.composio.dev/toolkits/content_studio.md"
product: "platform"
version: null
last_updated: null
---

# ContentStudio

ContentStudio is a social media management platform for publishing, workspace collaboration, analytics, and social inbox workflows.

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 72
- **Triggers:** 0
- **Slug:** `CONTENT_STUDIO`
- **Version:** 00000000_00

## Tools

### Add Facebook Group Account

**Slug:** `CONTENT_STUDIO_ADD_FACEBOOK_GROUP_ACCOUNT`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Facebook Group display name (3-255 characters). |
| `image` | string | No | Optional group image URL. Set to null or omit when no image is available. |
| `workspace_id` | string | Yes | Target workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Inbox Note

**Slug:** `CONTENT_STUDIO_ADD_INBOX_NOTE`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Internal note text visible to ContentStudio workspace users. |
| `platform_id` | string | Yes | Connected account ID from List Social Accounts. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox conversation. |
| `platform_type` | string ("facebook" | "instagram" | "linkedin" | "gmb" | "youtube") | Yes | Platform type of the Social Inbox conversation: facebook, instagram, linkedin, gmb, or youtube. |
| `conversation_id` | string | Yes | Social Inbox conversation reference to annotate. |
| `idempotency_key` | string | No | Retry de-duplication key. Reuse the same key only when retrying the identical note creation request. |
| `mentioned_user_ids` | array | No | ContentStudio workspace user IDs to mention in the internal note. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Post Comment

**Slug:** `CONTENT_STUDIO_ADD_POST_COMMENT`

Add 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Text of the post collaboration comment. |
| `post_id` | string | Yes | ContentStudio post or plan ID to comment on. |
| `workspace_id` | string | Yes | Workspace ID containing the ContentStudio post. |
| `mentioned_user_ids` | array | No | Workspace user IDs to mention in the post collaboration comment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Post Note

**Slug:** `CONTENT_STUDIO_ADD_POST_NOTE`

Add 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Text of the internal note to add to the post. |
| `post_id` | string | Yes | ContentStudio post or plan ID to comment on. |
| `workspace_id` | string | Yes | Workspace ID containing the ContentStudio post. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Set Inbox Elements Archived

**Slug:** `CONTENT_STUDIO_BULK_SET_INBOX_ELEMENTS_ARCHIVED`

Archive or unarchive 1-100 ContentStudio Social Inbox elements in one provider batch.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `archived` | boolean | Yes | Set every selected element's archive state. |
| `element_refs` | array | Yes | Exactly 1-100 Social Inbox element references to update. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox elements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Set Inbox Elements Status

**Slug:** `CONTENT_STUDIO_BULK_SET_INBOX_ELEMENTS_STATUS`

Set the workflow status of 1-100 ContentStudio Social Inbox elements to done or pending in one provider batch.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("done" | "pending") | Yes | Set every selected element's workflow status to done or pending. |
| `element_refs` | array | Yes | Exactly 1-100 Social Inbox element references to update. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox elements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Connect Bluesky Account

**Slug:** `CONTENT_STUDIO_CONNECT_BLUESKY_ACCOUNT`

Connect 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `handle` | string | Yes | Bluesky handle to connect, such as name.bsky.social. |
| `app_password` | string | Yes | Sensitive Bluesky app password used only for this connection request. It is never returned by this tool. |
| `workspace_id` | string | Yes | Target ContentStudio workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

**Slug:** `CONTENT_STUDIO_CREATE_CAMPAIGN`

Create a named, color-coded campaign in a ContentStudio workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Campaign name, up to 100 characters. |
| `color` | 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") | Yes | ContentStudio campaign color token. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Inbox Tag

**Slug:** `CONTENT_STUDIO_CREATE_INBOX_TAG`

Create a named, color-coded Social Inbox tag in a ContentStudio workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_name` | string | Yes | Name of the Social Inbox tag, up to 50 characters. |
| `tag_color` | string | Yes | Social Inbox tag color as a six-digit hex value in #RRGGBB format. |
| `workspace_id` | string | Yes | Workspace ID in which to create the Social Inbox tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Label

**Slug:** `CONTENT_STUDIO_CREATE_LABEL`

Create a named, color-coded label in a ContentStudio workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Label name, up to 100 characters. |
| `color` | 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") | Yes | ContentStudio label color token. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Post

**Slug:** `CONTENT_STUDIO_CREATE_POST`

Create a draft, queued, content-category, or scheduled ContentStudio post with complete 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | object | Yes | Complete ContentStudio post payload, preserving targeting, scheduling, media, platform options, organization, and approval configuration. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Workspace

**Slug:** `CONTENT_STUDIO_CREATE_WORKSPACE`

Create a ContentStudio workspace with its required name, logo URL, and timezone.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Campaign

**Slug:** `CONTENT_STUDIO_DELETE_CAMPAIGN`

Permanently delete a campaign from a ContentStudio workspace. Posts assigned to the campaign are detached from it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign ID to permanently delete. |
| `workspace_id` | string | Yes | Workspace ID containing the campaign. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Inbox Comment

**Slug:** `CONTENT_STUDIO_DELETE_INBOX_COMMENT`

Permanently delete one public ContentStudio Social Inbox comment from its connected social platform. This destructive operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Social Inbox comment ID to permanently delete. |
| `comment_urn` | string | No | LinkedIn comment URN. Required when platform_type is LinkedIn. |
| `platform_id` | string | Yes | Connected social account ID associated with the comment. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox comment. |
| `platform_type` | string ("facebook" | "instagram" | "linkedin" | "youtube") | Yes | Comment platform: facebook, instagram, linkedin, or youtube. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Inbox Message

**Slug:** `CONTENT_STUDIO_DELETE_INBOX_MESSAGE`

Soft-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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message_id` | string | Yes | Social Inbox message ID to soft-delete. |
| `platform_id` | string | Yes | Connected social account ID that owns the message. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Inbox Review Reply

**Slug:** `CONTENT_STUDIO_DELETE_INBOX_REVIEW_REPLY`

Permanently delete the business reply from one ContentStudio Social Inbox review. This does not delete the review itself.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_id` | string | Yes | Social Inbox review reference whose business reply will be deleted. |
| `platform_id` | string | Yes | Connected social account ID associated with the review. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox review. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Inbox Tags

**Slug:** `CONTENT_STUDIO_DELETE_INBOX_TAGS`

Permanently delete one or more ContentStudio Social Inbox tags by ID. This destructive batch operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_ids` | array | Yes | One or more Social Inbox tag IDs to permanently delete. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox tags. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Label

**Slug:** `CONTENT_STUDIO_DELETE_LABEL`

Permanently delete a label from a ContentStudio workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | string | Yes | Label ID to permanently delete. |
| `workspace_id` | string | Yes | Workspace ID containing the label. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Post

**Slug:** `CONTENT_STUDIO_DELETE_POST`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Post ID to permanently delete. |
| `account_ids` | array | No | Social account IDs to target for platform deletion. Omit to target all accounts on which the post was published. |
| `workspace_id` | string | Yes | Workspace ID containing the post. |
| `delete_from_social` | boolean | No | Whether to attempt deletion from published social platforms before removing the ContentStudio post. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Workspace

**Slug:** `CONTENT_STUDIO_DELETE_WORKSPACE`

Permanently delete a workspace and its workspace-scoped state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | Yes | Workspace ID to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AI Insights

**Slug:** `CONTENT_STUDIO_GET_AI_INSIGHTS`

Generate 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of insights for this single response. This is a result cap, not a page size or pagination control. |
| `end_date` | string | Yes | Inclusive analytics end date in YYYY-MM-DD format. |
| `language` | string | No | Response language as an ISO 639-1 code. |
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "youtube") | Yes | Connected-account platform used to select one of the seven documented AI-insights routes. Twitter has no AI-insights route. |
| `timezone` | string | No | IANA timezone used to interpret the analytics date range. |
| `start_date` | string | Yes | Inclusive analytics start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Analytics Summary

**Slug:** `CONTENT_STUDIO_GET_ANALYTICS_SUMMARY`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board_id` | string | No | Pinterest-only board ID used to restrict the summary to one board. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube") | Yes | Analytics platform. Must match the platform of the account selected with platform_id: facebook, gmb, instagram, linkedin, pinterest, tiktok, twitter, or youtube. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audience Demographics

**Slug:** `CONTENT_STUDIO_GET_AUDIENCE_DEMOGRAPHICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report` | string ("demographics" | "overview" | "location" | "top_geographies") | Yes | 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. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "instagram" | "linkedin" | "youtube") | Yes | Connected-account platform: facebook, instagram, linkedin, or youtube. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `date_range` | string | No | Facebook-only date override in `YYYY-MM-DD - YYYY-MM-DD` format. It overrides start_date and end_date upstream. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audience Growth Analytics

**Slug:** `CONTENT_STUDIO_GET_AUDIENCE_GROWTH_ANALYTICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report` | string ("audience_growth" | "follower_trend" | "subscriber_trend") | Yes | Growth report. Use audience_growth for Facebook, Instagram, or LinkedIn; follower_trend for Pinterest, TikTok, or Twitter; and subscriber_trend for YouTube. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube") | Yes | Connected-account platform: facebook, instagram, linkedin, pinterest, tiktok, twitter, or youtube. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `date_range` | string | No | Facebook audience_growth period-only override in `YYYY-MM-DD - YYYY-MM-DD` format. It overrides start_date and end_date upstream. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `granularity` | string ("period" | "daily") | No | Report granularity. Daily is supported only for Pinterest follower_trend and YouTube subscriber_trend; all other combinations require period. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Content Analytics

**Slug:** `CONTENT_STUDIO_GET_CONTENT_ANALYTICS`

Get 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube") | Yes | Platform of the content and connected account: facebook, gmb, instagram, linkedin, pinterest, tiktok, twitter, or youtube. |
| `content_id` | string | Yes | 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. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `CONTENT_STUDIO_GET_CURRENT_USER`

Return the active ContentStudio user associated with the connected API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Engagement Analytics

**Slug:** `CONTENT_STUDIO_GET_ENGAGEMENT_ANALYTICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report` | string ("active_users" | "impressions" | "engagement" | "actions" | "page_views" | "engagement_impressions" | "views" | "watch_time") | Yes | 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. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube") | Yes | 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. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `date_range` | string | No | Facebook-only date override in `YYYY-MM-DD - YYYY-MM-DD` format. It overrides start_date and end_date upstream. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `granularity` | string ("period" | "daily") | No | 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. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get GMB Activity Analytics

**Slug:** `CONTENT_STUDIO_GET_GMB_ACTIVITY_ANALYTICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | 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. |
| `report` | string ("search_keywords" | "reviews" | "media_activity") | Yes | GMB activity report to return: search_keywords, reviews, or media_activity. This selector chooses one of exactly three documented Google Business Profile analytics routes. |
| `end_date` | string | Yes | Inclusive report end date in YYYY-MM-DD format. |
| `timezone` | string | No | IANA timezone used to group report dates. |
| `start_date` | string | Yes | Inclusive report start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected Google Business Profile location. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Inbox Contact

**Slug:** `CONTENT_STUDIO_GET_INBOX_CONTACT`

Get the contact profile associated with a ContentStudio Social Inbox element.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `element_ref` | string | Yes | Canonical element reference or provider element ID from Search Inbox Elements. |
| `platform_id` | string | No | Connected account ID used to disambiguate a provider element ID shared across accounts. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Media Performance Analytics

**Slug:** `CONTENT_STUDIO_GET_MEDIA_PERFORMANCE_ANALYTICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report` | string ("reels" | "video" | "hashtags" | "stories") | Yes | Media report supported by the selected platform. Facebook supports reels and video; Instagram supports hashtags, stories, and reels; LinkedIn supports hashtags. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "instagram" | "linkedin") | Yes | Platform of the connected account. It must match platform_id: ContentStudio can return plausible empty or zero-filled analytics for a mismatched account ID. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `date_range` | string | No | 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. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Publishing Analytics

**Slug:** `CONTENT_STUDIO_GET_PUBLISHING_ANALYTICS`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report` | string ("publishing_behavior" | "posts_per_day" | "pin_posting" | "pin_posting_daily" | "pin_rollup" | "find_video" | "video_sharing" | "performance_schedule") | Yes | 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. |
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "youtube") | Yes | 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. |
| `timezone` | string | No | IANA timezone used to group analytics dates. |
| `date_range` | string | No | Facebook publishing-behavior date override in `YYYY-MM-DD - YYYY-MM-DD` format. Unsupported by every other route. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `media_types` | array | No | 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. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Twitter Credits Used

**Slug:** `CONTENT_STUDIO_GET_TWITTER_CREDITS_USED`

Return 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date in YYYY-MM-DD format. |
| `timezone` | string | No | IANA timezone used for the credit-usage date range. |
| `start_date` | string | Yes | Inclusive start date in YYYY-MM-DD format. |
| `platform_id` | string | Yes | 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. |
| `workspace_id` | string | Yes | Workspace containing the connected Twitter/X account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Invite Team Member

**Slug:** `CONTENT_STUDIO_INVITE_TEAM_MEMBER`

Invite 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("admin" | "approver" | "collaborator") | Yes | Workspace role to assign to the invited member. |
| `email` | string | Yes | Email address to invite to the workspace. |
| `membership` | string ("team" | "client") | No | Membership class to assign to the invitee. |
| `permissions` | object | No | Optional exact permission map containing boolean capabilities and per-platform or content-category ID arrays. |
| `workspace_id` | string | Yes | Workspace ID to invite the member into. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Approval Workflows

**Slug:** `CONTENT_STUDIO_LIST_APPROVAL_WORKFLOWS`

List 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `CONTENT_STUDIO_LIST_CAMPAIGNS`

List or search campaigns in a ContentStudio workspace and return campaign IDs for post assignment. Returns one page and a cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Case-insensitive partial campaign-name search. |
| `page_size` | integer | No | Maximum campaigns to return in this page (1-100). |
| `next_cursor` | string | No | Cursor from the previous page; omit for the first page. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Connection Platforms

**Slug:** `CONTENT_STUDIO_LIST_CONNECTION_PLATFORMS`

List every social platform supported by ContentStudio account connection and identify whether each uses OAuth, credentials, or a manual flow.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Content Categories

**Slug:** `CONTENT_STUDIO_LIST_CONTENT_CATEGORIES`

List or search content categories in a ContentStudio workspace and return category IDs usable when targeting posts. Returns one page and a cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum number of content categories to return in this page (1-100). |
| `next_cursor` | string | No | Cursor from a previous response; omit for the first page. |
| `search_terms` | array | No | Category-name search terms. Multiple terms are sent as one comma-separated search filter. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Facebook Text Backgrounds

**Slug:** `CONTENT_STUDIO_LIST_FACEBOOK_TEXT_BACKGROUNDS`

List every Facebook colored-text background preset ID usable in facebook_options on plain-text posts.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Inbox Conversation Content

**Slug:** `CONTENT_STUDIO_LIST_INBOX_CONVERSATION_CONTENT`

List messages, internal notes, or bookmarked messages for one ContentStudio Social Inbox conversation. Only messages support pagination and sorting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum messages to return (1-200). Valid only when content_type is messages. |
| `sort_order` | string ("asc" | "desc") | No | Chronological message order. Valid only when content_type is messages. |
| `next_cursor` | string | No | Message-page cursor from a previous call. Valid only when content_type is messages. |
| `content_type` | string ("messages" | "notes" | "bookmarks") | Yes | Conversation content to list: messages, internal notes, or bookmarked messages. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |
| `conversation_id` | string | Yes | Social Inbox conversation reference from Search Inbox Elements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Inbox Post Comments

**Slug:** `CONTENT_STUDIO_LIST_INBOX_POST_COMMENTS`

List 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Platform post reference returned by a Social Inbox search. |
| `page_size` | integer | No | Maximum top-level comment threads to return in this page (1-200). |
| `next_cursor` | string | No | Cursor from a previous response; omit for the first page. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Inbox Tags

**Slug:** `CONTENT_STUDIO_LIST_INBOX_TAGS`

List all Social Inbox tags in a ContentStudio workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Labels

**Slug:** `CONTENT_STUDIO_LIST_LABELS`

List or search labels in a ContentStudio workspace. Returned label_id values can be used to assign labels when creating or updating posts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Case-insensitive partial label-name search. |
| `page_size` | integer | No | Maximum number of labels to return in this page (1-100). |
| `next_cursor` | string | No | Cursor from a previous response; omit for the first page. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Media

**Slug:** `CONTENT_STUDIO_LIST_MEDIA`

List and filter media-library assets in a ContentStudio workspace. Returns one page with media IDs usable when creating or updating posts.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Post Comments

**Slug:** `CONTENT_STUDIO_LIST_POST_COMMENTS`

List collaboration comments and internal notes on a ContentStudio post. Returns one page and a cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | ContentStudio post ID whose collaboration comments to list. |
| `page_size` | integer | No | Maximum comments to return in this page (1-100). |
| `next_cursor` | string | No | Cursor from the previous page; omit for the first page. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Posts

**Slug:** `CONTENT_STUDIO_LIST_POSTS`

List 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Ranked Content Analytics

**Slug:** `CONTENT_STUDIO_LIST_RANKED_CONTENT_ANALYTICS`

List one offset-paginated page of top, least-performing, sorted, or pin-performance content analytics for one connected account. First use CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS and match its exact `_id`, workspace, and platform; a guessed account ID can produce a plausible successful empty response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ranking` | string ("top" | "sorted_top" | "least" | "pin_performance") | Yes | 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. |
| `end_date` | string | Yes | Inclusive analytics end date in YYYY-MM-DD format. |
| `hashtags` | array | No | Hashtag filters for Instagram or LinkedIn sorted-top content. |
| `order_by` | 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") | No | 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. |
| `platform` | string ("facebook" | "gmb" | "instagram" | "linkedin" | "pinterest" | "tiktok" | "twitter" | "youtube") | Yes | 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. |
| `timezone` | string | No | IANA timezone used to interpret and group analytics dates. |
| `page_size` | integer | No | Maximum ranked items to return in this page (1-100). |
| `date_range` | string | No | Facebook-only `YYYY-MM-DD - YYYY-MM-DD` date override sent as `date`. |
| `start_date` | string | Yes | Inclusive analytics start date in YYYY-MM-DD format. |
| `media_types` | array | No | 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. |
| `next_cursor` | string | No | Non-negative offset cursor returned by the previous page; omit for the first page. |
| `platform_id` | string | Yes | 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. |
| `topic_types` | array | No | GMB STANDARD, OFFER, or EVENT topic filters sent upstream as topic_type. |
| `tweet_types` | array | No | Twitter tweet-type filters sent upstream as tweet_type. |
| `entity_types` | array | No | Instagram FEED, REELS, or STORY entity filters. |
| `workspace_id` | string | Yes | Workspace containing the connected social account. |
| `ranking_metric` | string ("post_engagement" | "engagements_count" | "likes_count" | "comments_count" | "shares_count" | "views_count" | "created_time") | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Social Accounts

**Slug:** `CONTENT_STUDIO_LIST_SOCIAL_ACCOUNTS`

List connected social accounts in a ContentStudio workspace. Use each returned account_id (the provider's _id) as platform_id for analytics and Social Inbox calls; a workspace ID or fabricated account ID can produce misleading empty analytics instead of an error.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Team Members

**Slug:** `CONTENT_STUDIO_LIST_TEAM_MEMBERS`

List or search team members in a ContentStudio workspace and return user and membership IDs, roles, memberships, and available permissions. Returns one page and a cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Name or email search term. |
| `page_size` | integer | No | Maximum team members to return in this page (1-100). |
| `next_cursor` | string | No | Cursor from the previous page; omit for the first page. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workspaces

**Slug:** `CONTENT_STUDIO_LIST_WORKSPACES`

List workspaces accessible to the connected account and return workspace IDs for workspace-scoped tools. Returns one page and a cursor for continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum workspaces to return in this page (1-100). |
| `next_cursor` | string | No | Cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Mark Inbox Element Read

**Slug:** `CONTENT_STUDIO_MARK_INBOX_ELEMENT_READ`

Mark 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `element_ref` | string | Yes | Social Inbox element reference to mark as read. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox element. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Merge Inbox Tags

**Slug:** `CONTENT_STUDIO_MERGE_INBOX_TAGS`

Irreversibly 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_ids` | array | Yes | IDs of at least two source tags to replace. The merge removes these source tags as distinct tags and cannot be undone. |
| `tag_name` | string | Yes | Name for the replacement tag created by the merge. |
| `tag_color` | string | Yes | Color for the replacement tag created by the merge, as a six-digit hex value in #RRGGBB format. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox source tags. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Social Account

**Slug:** `CONTENT_STUDIO_REMOVE_SOCIAL_ACCOUNT`

Disconnect a social account from a ContentStudio workspace. The connected user must have the workspace's save_social permission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Connected account _id from List Social Accounts. |
| `workspace_id` | string | Yes | Workspace ID containing the connected social account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Team Member

**Slug:** `CONTENT_STUDIO_REMOVE_TEAM_MEMBER`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `confirmed` | boolean | No | 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. |
| `member_id` | string | Yes | Membership ID from List Team Members, not the user's account ID. |
| `workspace_id` | string | Yes | Workspace ID containing the member. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reply To Inbox Review

**Slug:** `CONTENT_STUDIO_REPLY_TO_INBOX_REVIEW`

Publish a public business reply to a ContentStudio Social Inbox review, replacing its existing reply when one exists. This immediately causes an irreversible external send.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_id` | string | Yes | Review reference returned by Social Inbox search. |
| `platform_id` | string | Yes | Connected social account ID associated with the review. |
| `review_reply` | string | Yes | Public business reply to publish. This immediately creates or replaces the existing external review reply. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox review. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Review Post Approval

**Slug:** `CONTENT_STUDIO_REVIEW_POST_APPROVAL`

Approve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("approve" | "reject") | Yes | Approval decision to record for the post. |
| `comment` | string | No | Optional comment explaining the approval or rejection. |
| `post_id` | string | Yes | Post ID to approve or reject. |
| `workspace_id` | string | Yes | Workspace ID containing the post awaiting review. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Inbox Elements

**Slug:** `CONTENT_STUDIO_SEARCH_INBOX_ELEMENTS`

Search one page of ContentStudio Social Inbox conversations, posts, and reviews using status, text, tag, channel, and targeted-element filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Tag IDs to require on returned Inbox elements. |
| `action` | string ("all" | "marked_done" | "archived" | "assigned") | No | Status filter: all, marked_done, archived, or assigned. |
| `page_size` | integer | No | Maximum Inbox elements to return in this page (1-200). |
| `inbox_types` | array | No | Inbox element types to include: conversation, post, or review. |
| `next_cursor` | string | No | Cursor from a previous response; omit for the first page. |
| `search_term` | string | No | Text to search for across Social Inbox elements. |
| `all_channels` | object | No | Social platform names mapped to the account IDs to search. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |
| `targeted_element` | string | No | Specific Inbox element reference to target when narrowing the search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Inbox Comment

**Slug:** `CONTENT_STUDIO_SEND_INBOX_COMMENT`

Publish 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | No | Text to send. Provide message, attachment_file, or both; at least one is required. |
| `post_id` | string | Yes | Platform post reference from Inbox search. |
| `comment_id` | string | No | Parent comment ID when publishing a public reply to a specific comment. |
| `platform_id` | string | Yes | Connected account ID from List Social Accounts. |
| `workspace_id` | string | Yes | Workspace ID. |
| `platform_type` | string | Yes | Platform type of the public Social Inbox post. |
| `attachment_file` | object | No | 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. |
| `idempotency_key` | string | No | Retry de-duplication key. Reuse it for sequential retries of the same send; concurrent duplicate sends may both be delivered. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Inbox Message

**Slug:** `CONTENT_STUDIO_SEND_INBOX_MESSAGE`

Send 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | No | 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. |
| `message` | string | No | Message text. Provide message, file, or both. |
| `file_type` | string ("image" | "video") | No | Attachment type: image or video. Required with file and invalid without file. |
| `platform_id` | string | Yes | Connected account ID from List Social Accounts. |
| `workspace_id` | string | Yes | Workspace ID. |
| `platform_type` | string ("facebook" | "instagram") | Yes | Conversation platform: facebook or instagram. |
| `conversation_id` | string | Yes | Social Inbox conversation reference to message. |
| `idempotency_key` | string | No | Retry de-duplication key. Reuse it only for sequential retries of the same send; concurrent duplicate requests may both be delivered. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Inbox Private Reply

**Slug:** `CONTENT_STUDIO_SEND_INBOX_PRIVATE_REPLY`

Send 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | No | Private Facebook message text. Provide message, attachment_file, or both; at least one is required. |
| `post_id` | string | Yes | Platform post reference from Inbox search. |
| `platform_id` | string | Yes | Connected account ID from List Social Accounts. |
| `workspace_id` | string | Yes | Workspace ID. |
| `attachment_file` | object | No | 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. |
| `idempotency_key` | string | No | Retry de-duplication key. Reuse it for sequential retries of the same send; concurrent duplicate sends may both be delivered. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Inbox Comment Hidden

**Slug:** `CONTENT_STUDIO_SET_INBOX_COMMENT_HIDDEN`

Hide or unhide one ContentStudio Social Inbox comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hidden` | boolean | Yes | Strict boolean: true hides the comment; false unhides it. |
| `comment_id` | string | Yes | Social Inbox comment ID whose hidden state will change. |
| `platform_id` | string | No | Connected social account ID from List Social Accounts. Required only when unhiding the comment. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox comment. |
| `platform_type` | string ("facebook" | "instagram") | No | Comment platform, facebook or instagram. Required only when unhiding the comment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Inbox Comment Liked

**Slug:** `CONTENT_STUDIO_SET_INBOX_COMMENT_LIKED`

Like or unlike one ContentStudio Social Inbox comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `liked` | boolean | Yes | Strict boolean: true likes the comment; false unlikes it. |
| `comment_id` | string | Yes | Social Inbox comment ID whose liked state will change. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox comment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Inbox Message Bookmarked

**Slug:** `CONTENT_STUDIO_SET_INBOX_MESSAGE_BOOKMARKED`

Bookmark or unbookmark one ContentStudio Social Inbox message.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmarked` | boolean | Yes | Strict boolean: true bookmarks the message; false unbookmarks it. |
| `message_id` | string | Yes | Social Inbox message ID whose bookmarked state will change. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox message. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Summarize Inbox Elements

**Slug:** `CONTENT_STUDIO_SUMMARIZE_INBOX_ELEMENTS`

Count 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `inbox_types` | array | No | Social Inbox element types to include in the counts. |
| `all_channels` | object | No | Social platform names mapped to the connected account IDs to include. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Campaign

**Slug:** `CONTENT_STUDIO_UPDATE_CAMPAIGN`

Update a campaign's name or color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New campaign name. |
| `color` | 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") | No | New color token. |
| `campaign_id` | string | Yes | Campaign ID from List Campaigns. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Inbox Contact

**Slug:** `CONTENT_STUDIO_UPDATE_INBOX_CONTACT`

Partially 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New contact name; omit to preserve it. |
| `email` | string | No | New contact email address; omit to preserve it. |
| `phone` | string | No | New contact phone number; omit to preserve it. |
| `company` | string | No | New contact company; omit to preserve it. |
| `element_ref` | string | Yes | Canonical Social Inbox element reference or provider element ID. |
| `platform_id` | string | Yes | Required ContentStudio connected-account ID from List Social Accounts. It disambiguates provider element IDs that exist under multiple accounts. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox element. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Inbox Element Tags

**Slug:** `CONTENT_STUDIO_UPDATE_INBOX_ELEMENT_TAGS`

Add one or more tags to a ContentStudio Inbox element or remove one tag from it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | No | Single tag ID to remove. Required only when operation is remove. |
| `tag_ids` | array | No | Non-empty tag ID list to add. Required only when operation is add. |
| `operation` | string ("add" | "remove") | Yes | Tag update to perform: add one or more tags, or remove one tag. |
| `inbox_type` | string ("conversation" | "post" | "review") | Yes | Inbox element type: conversation, post, or review. |
| `element_ref` | string | Yes | Social Inbox element reference from Search Inbox Elements. |
| `platform_id` | string | Yes | Connected social account ID that owns the Inbox element. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox element. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Inbox Tag

**Slug:** `CONTENT_STUDIO_UPDATE_INBOX_TAG`

Update a ContentStudio Social Inbox tag's name or color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | Yes | Social Inbox tag ID to update. |
| `tag_name` | string | No | New tag name. |
| `tag_color` | string | No | New tag color as a six-digit hex value in #RRGGBB format. |
| `workspace_id` | string | Yes | Workspace ID containing the Social Inbox tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Label

**Slug:** `CONTENT_STUDIO_UPDATE_LABEL`

Update a label's name or color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New label name. |
| `color` | 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") | No | New color token. |
| `label_id` | string | Yes | Label ID from List Labels. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Post

**Slug:** `CONTENT_STUDIO_UPDATE_POST`

Fully 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | object | Yes | Complete replacement payload. Omitted optional fields are removed or reset according to ContentStudio's full-replacement behavior. |
| `post_id` | string | Yes | Unpublished post ID from List Posts. |
| `workspace_id` | string | Yes | Workspace ID from List Workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Team Member

**Slug:** `CONTENT_STUDIO_UPDATE_TEAM_MEMBER`

Replace 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Workspace

**Slug:** `CONTENT_STUDIO_UPDATE_WORKSPACE`

Update selected settings of an existing workspace.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Media

**Slug:** `CONTENT_STUDIO_UPLOAD_MEDIA`

Upload one media file or import one public media URL into a ContentStudio workspace media library.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Public media URL to import. Provide this or file, but not both. |
| `file` | object | No | 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. |
| `folder_id` | string | No | Destination media-library folder ID, when applicable. |
| `workspace_id` | string | Yes | Workspace ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |