# ContentStudio integration

> Social media management platform: schedule and publish posts, manage the content library, social inbox, automations, approvals, analytics and AI image/video generation.

- Authentication: apiKey

## Tools (356)

- **Abandon a bulk upload**: Throws away everything in the batch that is still pending, so nothing further from this file is ever scheduled.
- **Add a comment to a post**: Create a new comment or internal note on a post
- **Add a Facebook Group manually**: Adds a Facebook Group connection using its name and an optional image URL.
- **Add an internal note**: Add an internal note
- **Add a posting slot to a category**: Create one weekly posting slot.
- **Add or replace a review reply (upsert)**: Add or replace a review reply (upsert)
- **Add posts to an evergreen automation**: Appends one or more posts to the automation's recycling pool in a single atomic write, so concurrent callers cannot overwrite each other — safe to drive from a webhook or a no-code step.
- **Ad groups with per-ad-group metrics**: Pass `campaign_id` to drill into one campaign's ad groups; omit it for every ad group in the account.
- **Ad sets with per-ad-set metrics**: Pass `campaign_id` to drill into one campaign's ad sets; omit it for every ad set in the account.
- **Ads with per-ad metrics**: Scope with `campaign_id`, `ad_group_id`, both, or neither.
- **Ads with per-ad metrics and creative details**: Scope with `campaign_id`, `ad_set_id`, both, or neither.
- **AI-generated insights for an ad account (Google Ads)**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **AI-generated insights for an ad account (Meta Ads)**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **Approve or delete bulk upload rows**: Approves the named rows — which is what schedules them — or deletes them.
- **Approve or reject a post**: Approve or reject a single post that is under review with an optional comment.
- **Archive or unarchive media**: Archiving hides media from the default library listing without deleting it — the safe alternative to deletion for media attached to posts that have not published yet.
- **A single Threads post by media id**: Looked up by identity: the post is resolved by `post_id`, so one published outside the dashboard window is still openable and the range never filters it out.
- **Attach a campaign to bulk upload rows**: Puts pending rows in a campaign (folder), before they are approved.
- **Attach labels to bulk upload rows**: Sets the labels on pending rows, before they are approved.
- **Attach tags to an element**: Attach tags to an element
- **Audience breakdown by age and gender, region or country**: `breakdown=age_gender` returns the age/gender matrix under `by_age` and `by_gender`, each row a `{label, value, percent}` for the single selected `metric`.
- **Audience breakdown by age, gender and location**: Unlike the Meta endpoint, this returns every demographic breakdown the account has in one response rather than taking a `breakdown` selector.
- **Bluesky engagement trend by post publish date**: Engagement earned by the posts PUBLISHED on each day, measured at the last sync — not engagement that occurred on that day.
- **Bluesky follower trend, tracked since connection**: Daily follower totals assembled from the snapshots ContentStudio retained.
- **Bluesky paginated post table (default 15)**: Same payload and sort options as top-posts with a larger default page size, for the sortable posts table.
- **Bluesky posting cadence by weekday**: How many posts were published on each weekday.
- **Bluesky publishing behaviour with a per-media-type rollup**: Posting volume and engagement over time, plus a rollup broken down by media type (text, image, gallery, video, link, record, other) with a `total` row.
- **Bluesky single post detail**: One authored post by its record key (rkey — the last segment of the at:// uri).
- **Bluesky summary KPIs — current vs previous period**: Authored-post totals for the period plus the current profile counters.
- **Bluesky top authored posts (default 3)**: Highest-performing authored posts.
- **Bluesky top hashtags by engagement**: Top hashtags from richtext tag facets and the record's explicit tags.
- **Brand knowledge status**: Reports whether the workspace has brand knowledge and whether it is enabled.
- **Bulk element state change (done / pending / archive / assign)**: Bulk element state change (done / pending / archive / assign)
- **Campaign & label summary KPIs — current vs previous period**: `total_engagement_rate_per_impression` and the per-post `engagement_rate` are percentages (engagement / impressions * 100) on every platform.
- **Campaigns with per-campaign metrics (Google Ads)**: Paginated with `limit`/`offset`.
- **Campaigns with per-campaign metrics (Meta Ads)**: Paginated with `limit`/`offset`.
- **Cancel an async video job**: Cancels a still-active job via the matching engine (Dramatiq or Temporal).
- **Check an RSS feed URL**: Fetches the feed and reports whether it is readable, without creating anything.
- **Competitor page bio and profile info**: Competitor page bio and profile info
- **Competitor profile bio and info**: Competitor profile bio and info
- **Connect a Bluesky account with credentials**: Connects a Bluesky profile using a handle and app password.
- **Conversion actions configured on the account**: The conversion actions themselves — what the account is set up to count.
- **Conversion funnel — impressions through to conversions**: Conversion funnel — impressions through to conversions
- **Conversions grouped by conversion action**: Conversions grouped by conversion action
- **Conversions over time**: Daily conversion counts and value.
- **Create a campaign**: Create a new campaign (folder) in the specified workspace.
- **Create a content category**: Create a new content category in the specified workspace.
- **Create a label**: Create a new label in the specified workspace.
- **Create a media folder**: Creates a folder in the workspace content library.
- **Create an approval workflow**: Create a multi-level approval workflow with up to 5 levels.
- **Create an evergreen automation**: Creates an evergreen automation that recycles a pool of posts on a repeating schedule.
- **Create a new social media post**: Create a new social media post with simplified payload structure
- **Create an RSS automation**: Creates an RSS feed automation that posts new feed items to the selected accounts.
- **Create a report schedule**: Sets a report to build automatically.
- **Create a saved competitor report**: There is no maximum number of competitors per report, and competitors are not metered individually.
- **Create a shareable analytics link**: Creates a link that anyone holding the URL can open without a ContentStudio account.
- **Create a shareable link**: Create a public link to a set of posts or a calendar window.
- **Create a tag**: Create a tag
- **Create a workspace**: Creates a new workspace owned by the authenticated user.
- **Daily time series for one or more metrics (Google Ads)**: Ask for several metrics at once with `metrics=spend,clicks,conversions` and they arrive under `series`, keyed by metric name — one request, one query, however many metrics.
- **Daily time series for one or more metrics (Meta Ads)**: Ask for several metrics at once with `metrics=spend,impressions,clicks` and they arrive under `series`, keyed by metric name — one request, one query, however many metrics.
- **Daily time series per campaign and per label**: The same three universally-reported metrics as the breakdown endpoint, but as a daily series rather than a period total — this is what backs the trend graphs.
- **Delete a campaign**: Permanently delete a campaign (folder) from the workspace.
- **Delete a comment**: Delete a comment
- **Delete a content category**: Permanently delete a content category.
- **Delete a cross-workspace report**: Delete a cross-workspace report
- **Delete a label**: Permanently delete a label from the workspace.
- **Delete a media folder**: **Irreversible and cascading.** Deleting a folder also permanently deletes every subfolder beneath it and every media file inside them, from both the library and cloud storage.
- **Delete a message (soft)**: Delete a message (soft)
- **Delete an approval workflow**: Delete an approval workflow.
- **Delete an evergreen automation**: Permanently deletes the automation AND the posts it has scheduled.
- **Delete an RSS automation**: Permanently deletes the automation AND the posts it has scheduled.
- **Delete a posting slot**: Remove one weekly posting slot from a category.
- **Delete a report**: Delete a report
- **Delete a report schedule**: Stops the recurring report.
- **Delete a review reply**: Delete a review reply
- **Delete a saved competitor report**: Delete a saved competitor report
- **Delete a shareable analytics link**: Takes effect immediately: the URL stops working for everyone holding it.
- **Delete a shareable link**: Permanently delete a link; the public URL stops resolving immediately.
- **Delete a social media post**: Delete a specific social media post by ID.
- **Delete a workspace**: Soft-deletes a workspace and schedules permanent removal.
- **Delete media permanently**: **Irreversible.** Permanently deletes the media file from the library and from cloud storage.
- **Delete tags (bulk)**: Delete tags (bulk)
- **Detach a tag from an element**: Detach a tag from an element
- **Download a sample bulk file**: A valid CSV with the exact columns a bulk submission expects, in order.
- **Duplicate an approval workflow**: Create a copy of an approval workflow, named `<name> (Copy)`.
- **Estimate video generation cost**: Real, model-priced credit cost and processing-time estimate for a generate() request.
- **Facebook AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **Facebook audience location (country/city breakdown)**: Country and city breakdown of the page's followers.
- **Facebook engagement by impression type over time**: Facebook engagement by impression type over time
- **Facebook fan / follower growth over time**: Facebook fan / follower growth over time
- **Facebook page engagements over time**: Facebook page engagements over time
- **Facebook page impressions over time**: Facebook page impressions over time
- **Facebook Reels performance over time**: Facebook Reels performance over time
- **Facebook summary KPIs — current vs previous period**: Facebook summary KPIs — current vs previous period
- **Facebook top posts (overview widget)**: Facebook top posts (overview widget)
- **Facebook top posts with media_type filter**: Facebook top posts with media_type filter
- **Facebook video view time and plays over time**: Facebook video view time and plays over time
- **Fetch post comments**: Retrieve a paginated list of comments for a specific post
- **Fetch social media posts**: Retrieve a paginated list of social media posts for a specific workspace with filtering options
- **Flag media as a brand asset**: Marks a media item as a brand asset so it feeds AI generation for the workspace's brand profile, exactly as flagging it from the Brand Knowledge tab does.
- **Follower growth comparison across competitors**: Follower growth comparison across competitors
- **Follower growth comparison across IG competitors**: Follower growth comparison across IG competitors
- **Generate a cross-workspace report**: Asynchronous, like every report: returns 202 and a report id.
- **Generate an image**: Synchronously generates one image and saves it to the workspace content library.
- **Generate a report**: Queues a report and returns its id immediately - the file is NOT ready when this call returns.
- **Get a category's next available posting slot**: Answer when a post queued into this category right now would publish.
- **Get an evergreen automation**: Get an evergreen automation
- **Get an RSS automation**: Get an RSS automation
- **Get a single approval workflow**: Retrieve one approval workflow, including drafts, plus its runtime in-flight metrics.
- **Get a single content category**: Retrieve one content category with its resolved social accounts AND its full weekly posting schedule, so a caller does not need a second request to understand when the category publishes.
- **Get a single Facebook post by ID**: Get a single Facebook post by ID
- **Get a single GMB post by ID**: Get a single GMB post by ID
- **Get a single Instagram post by ID**: Get a single Instagram post by ID
- **Get a single LinkedIn post by ID**: Get a single LinkedIn post by ID
- **Get a single Pinterest pin by ID**: Get a single Pinterest pin by ID
- **Get a single post**: Retrieve a single social media post by its ID for a specific workspace
- **Get a single shareable link**: Retrieve one share link.
- **Get a single TikTok post by ID**: Get a single TikTok post by ID
- **Get a single Twitter/X tweet by ID**: Get a single Twitter/X tweet by ID
- **Get a single YouTube video by ID**: Video metrics come from two YouTube APIs.
- **Get async video job status**: Status of a video job the public API submitted.
- **Get a team member's social account access**: List the social accounts a team member may use.
- **Get authenticated user information**: Retrieve information about the currently authenticated user.
- **Get bulk upload status**: Progress of a queued bulk file.
- **Get campaigns for a workspace**: Retrieve paginated list of campaigns (folders) for a specific workspace, sorted alphabetically by name.
- **Get cascade job status**: Poll the progress of a cascade dispatched by an approval-workflow update (`confirmed=true`) or a force delete.
- **Get content categories for a workspace**: Retrieve list of content categories for a specific workspace with resolved social account information.
- **Get labels for a workspace**: Retrieve paginated list of labels for a specific workspace, sorted alphabetically by name.
- **Get media storage limit and usage**: Returns the media storage limit, current usage and remaining space for the workspace, so an integration can check for room before uploading instead of discovering a full library as a failed request.
- **Get optimal posting times**: Analyse historical performance of the workspace's connected accounts and return the best times to publish, both pooled across accounts (`global`) and per account (`individual`).
- **Get plan limits and current usage**: Read every metered entitlement for a workspace with what has been used, what the plan allows, and whether it applies — the same figures the billing screen shows for the same workspace.
- **Get social media accounts for a workspace**: Retrieve paginated list of social media accounts for a specific workspace with optional platform filtering
- **Get user workspaces**: Returns paginated workspaces associated with the authenticated user
- **Get workspace team members**: Retrieve a paginated list of team members for a specific workspace.
- **GMB AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **GMB customer actions (clicks, calls, directions) over time**: GMB customer actions (clicks, calls, directions) over time
- **GMB impressions breakdown by channel and device over time**: GMB impressions breakdown by channel and device over time
- **GMB media (photo/video) activity over time**: GMB media (photo/video) activity over time
- **GMB posts published over time and topic-type breakdown**: GMB posts published over time and topic-type breakdown
- **GMB reviews — ratings, distribution, and daily activity**: GMB reviews — ratings, distribution, and daily activity
- **GMB summary KPIs — current vs previous period**: GMB summary KPIs — current vs previous period
- **GMB top-performing posts**: GMB top-performing posts
- **GMB top search keywords that surfaced the listing**: GMB top search keywords that surfaced the listing
- **Google Ads headline KPIs — current vs previous period**: Spend, impressions, clicks, CTR, average CPC and conversions for the requested range, each alongside the equivalent prior range and the absolute and percentage change.
- **Hide a comment (idempotent)**: Hide a comment (idempotent)
- **Inbox counts per bucket**: Inbox counts per bucket
- **Initiate an OAuth account connection or reconnection flow**: Generates a one-time authorization URL for OAuth-based social account connection.
- **Instagram active users by hour and day of week**: Instagram active users by hour and day of week
- **Instagram AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **Instagram audience age / gender breakdown**: Instagram audience age / gender breakdown
- **Instagram audience country / city breakdown**: Instagram reports top cities and top countries as two separate lists with nothing connecting them, so the country each city sits in is derived from the city label.
- **Instagram follower growth over time**: Instagram follower growth over time
- **Instagram post engagement by media type over time**: Instagram post engagement by media type over time
- **Instagram post engagement over time**: Instagram post engagement over time
- **Instagram post impressions over time**: Instagram post impressions over time
- **Instagram Reels engagement and watch time over time**: Instagram Reels engagement and watch time over time
- **Instagram stories impressions, reach, and interactions over time**: Instagram stories impressions, reach, and interactions over time
- **Instagram summary KPIs — current vs previous period**: `eng_rate` is engagement as a percentage of post views (`engagement / views * 100`), matching `engagement_rate` on the overview summary endpoint.
- **Instagram top hashtags by engagement**: Instagram top hashtags by engagement
- **Instagram top-performing posts**: Instagram top-performing posts
- **Instagram top posts with hashtag filter**: Instagram top posts with hashtag filter
- **Invite a team member**: Invite a member to a workspace by email, with a role and permissions.
- **Invoke a dedicated video tool**: Submits motion-control, lip-sync, or talking-avatar and returns a job handle immediately — the video is not ready yet.
- **Invoke an image tool**: Synchronously runs one image tool, validates against its live input schema, and saves the result to the workspace content library.
- **Keywords with per-keyword metrics**: The keywords being bid on, with their match type.
- **Like a comment (idempotent, Facebook)**: Like a comment (idempotent, Facebook)
- **LinkedIn AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **LinkedIn follower demographics by industry, country, and other dimensions**: LinkedIn follower demographics by industry, country, and other dimensions
- **LinkedIn follower growth over time**: LinkedIn follower growth over time
- **LinkedIn page views over time (desktop vs mobile)**: LinkedIn page views over time (desktop vs mobile)
- **LinkedIn post count distribution by day of week**: LinkedIn post count distribution by day of week
- **LinkedIn post engagement by media type over time**: `engagements`: Engagement counts reactions, comments, reposts and post clicks — the same components LinkedIn uses for `post_engagement_rate`, so counts and rates agree.
- **LinkedIn summary KPIs — current vs previous period**: `post_engagement` / `total_engagement`: Engagement counts reactions, comments, reposts and post clicks — the same components LinkedIn uses for `post_engagement_rate`, so counts and rates agree.
- **LinkedIn top hashtags by engagement**: `engagements` / `post_engagement`: Engagement counts reactions, comments, reposts and post clicks — the same components LinkedIn uses for `post_engagement_rate`, so counts and rates agree.
- **LinkedIn top-performing posts**: `post_engagement`: Engagement counts reactions, comments, reposts and post clicks — the same components LinkedIn uses for `post_engagement_rate`, so counts and rates agree.
- **LinkedIn top posts with hashtag and media type filter**: LinkedIn top posts with hashtag and media type filter
- **List a category's posting slots**: Retrieve every weekly posting slot on a content category, ordered by period then hour.
- **List AI image tools**: Live image-tool capabilities from the AI service, including each tool's JSON input schema.
- **List AI video tools**: Enabled video tools with their input descriptors, duration limits and cost.
- **List a post's comments (threaded)**: List a post's comments (threaded)
- **List approval workflows**: Retrieve the workspace's published (non-draft) multi-level approval workflows.
- **List async video jobs**: Video jobs the public API itself submitted for this workspace — never jobs originated by chat or internal tools, even though they share the same underlying record.
- **List available image models**: Live image-model catalogue from the AI service with supported dimension presets.
- **List available video models**: Every model the generate endpoint can select, with modes/resolutions/durations.
- **List a workspace's generated reports**: List a workspace's generated reports
- **List a workspace's report schedules**: List a workspace's report schedules
- **List a workspace's saved competitor reports**: List a workspace's saved competitor reports
- **List a workspace's shareable analytics links**: List a workspace's shareable analytics links
- **List bulk uploads**: List bulk uploads
- **List connected Google Ads accounts**: The starting point for every other Google Ads endpoint: it returns the `account_id` they all require, along with the account's currency.
- **List connected Meta ad accounts**: The starting point for every other Meta Ads endpoint: it returns the `account_id` they all require, along with the account's currency.
- **List evergreen automations**: List evergreen automations
- **List Facebook text-post background presets**: Returns the full list of Facebook colored-background preset IDs accepted by `facebook_options.facebook_background_id` on POST /api/v1/workspaces/{workspace_id}/posts.
- **List internal notes on a conversation**: List internal notes on a conversation
- **List media assets**: Retrieve a paginated list of media assets for a workspace with filtering, search, and sort options.
- **List media folders**: Returns every media-library folder in the workspace.
- **List messages in a conversation**: List messages in a conversation
- **List platforms available for account connection**: Returns supported platforms, their connection method, required fields, and the endpoint to use for each connection flow.
- **List RSS automations**: Paginated list of the workspace's RSS automations.
- **List shareable links**: Retrieve the workspace's planner share links, newest first.
- **List starred messages in a conversation**: List starred messages in a conversation
- **List the caller's cross-workspace reports**: List the caller's cross-workspace reports
- **List the rows a bulk upload produced**: The posts built from the uploaded file, awaiting review.
- **List the workspaces available for a cross-workspace report**: What the caller may combine.
- **List the workspace's inbox tags**: List the workspace's inbox tags
- **Mark an element read (idempotent)**: Mark an element read (idempotent)
- **Merge tags into a new one**: Merge tags into a new one
- **Meta Ads headline KPIs — current vs previous period**: Spend, reach, impressions, clicks, CPM, CPC and CTR for the requested range, each alongside the equivalent prior range and the absolute and percentage change.
- **Most-used hashtags across competitors**: Most-used hashtags across competitors
- **Most-used hashtags across IG competitors**: Most-used hashtags across IG competitors
- **Move media between folders**: Moves the given media into a folder.
- **One metric broken down by campaign, ad group or ad**: One metric broken down by campaign, ad group or ad
- **One metric broken down by campaign, ad set or ad**: One metric broken down by campaign, ad set or ad
- **One metric broken down by campaign type**: Search, Display, Video, Shopping, Performance Max and the rest — Google's advertising channel types.
- **One metric broken down by publisher platform and placement**: Where the ads actually ran — Facebook, Instagram, Audience Network, Messenger, and the device platform within each.
- **Pause or resume an evergreen automation**: Sets whether the automation is active.
- **Pause or resume an RSS automation**: Sets whether the automation is active.
- **Pause or resume a report schedule**: A schedule auto-pauses after max_attempts consecutive failures - read `active`, `paused_reason` and `consecutive_failures` to see whether that has happened.
- **Pause publishing for a workspace**: Holds every pending post in the workspace and stops publishing, exactly as the Pause Posting action in the web app does.
- **Per-campaign and per-label totals, current vs previous period**: Splits the same scope as the summary endpoint into one row per campaign and one per label, so each can be compared against the others and against its own previous period.
- **Per-competitor aggregate metrics table (Facebook Competitors)**: Per-competitor aggregate metrics table
- **Per-competitor aggregate metrics table (Instagram Competitors)**: Per-competitor aggregate metrics table
- **Per-post table for the selected campaigns & labels**: The top `limit` posts overall (or within `platforms`), server-sorted.
- **Pinterest AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **Pinterest cumulative engagement trend over time**: Pinterest cumulative engagement trend over time
- **Pinterest cumulative follower trend over time**: Pinterest cumulative follower trend over time
- **Pinterest cumulative impressions trend over time**: Pinterest cumulative impressions trend over time
- **Pinterest cumulative pin posting activity over time**: Pinterest cumulative pin posting activity over time
- **Pinterest daily-delta engagement trend**: Pinterest daily-delta engagement trend
- **Pinterest daily-delta follower trend**: Pinterest daily-delta follower trend
- **Pinterest daily-delta impressions trend**: Pinterest daily-delta impressions trend
- **Pinterest daily-delta pin posting activity**: Pinterest daily-delta pin posting activity
- **Pinterest pin performance metrics over time**: Pinterest pin performance metrics over time
- **Pinterest pin performance rollup — current vs previous period**: Pinterest pin performance rollup — current vs previous period
- **Pinterest summary KPIs — current vs previous period**: `engagement_rate` is a percentage (pin clicks + outbound clicks + saves, over impressions * 100).
- **Pinterest top-performing and least-performing pins**: Pinterest top-performing and least-performing pins
- **Post a comment, reply, or Facebook private reply**: Post a comment, reply, or Facebook private reply
- **Post engagement comparison across all competitors**: Post engagement comparison across all competitors
- **Post engagement trend for a single competitor**: Post engagement trend for a single competitor
- **Posting activity for a specific media type (Facebook Competitors)**: Posting activity for a specific media type
- **Posting activity for a specific media type (Instagram Competitors)**: Posting activity for a specific media type
- **Posting activity over time split by media type**: Posting activity over time split by media type
- **Posting activity split by media type over time**: Posting activity split by media type over time
- **Posts for a specific competitor hashtag (Facebook Competitors)**: Posts for a specific competitor hashtag
- **Posts for a specific competitor hashtag (Instagram Competitors)**: Posts for a specific competitor hashtag
- **Post type distribution across competitors**: Post type distribution across competitors
- **Publishing behaviour breakdown by content type**: How many videos of each content type were published in the range and how they performed.
- **Pull the feed's history now**: Runs the automation's feed pull immediately instead of waiting for its `pull_frequency`, which is how a feed is backfilled.
- **Reaction distribution grouped by competitor page**: Reaction distribution grouped by competitor page
- **Reaction type distribution for a single competitor**: Reaction type distribution for a single competitor
- **Read an account's analytics preferences**: Returns the stored preferences for a connected account.
- **Read an element's contact profile**: Read an element's contact profile
- **Read an RSS automation's posts**: The posts this automation produced.
- **Read an RSS automation's pull history**: What each feed pull did — how many new items it found and how many posts it created, or that it found nothing.
- **Read one cross-workspace report, including whether it is ready**: Read one cross-workspace report, including whether it is ready
- **Read one report, including whether it is ready**: This is the polling endpoint.
- **Read one report schedule**: Read one report schedule
- **Read one saved competitor report**: Read one saved competitor report
- **Read one shareable analytics link**: Read one shareable analytics link
- **Read what a client did through a share link**: Every comment and every approve/reject a recipient left through THIS link, newest first.
- **Read workspace settings**: Returns every workspace-level setting the product exposes, plus the workspace's posting state and the number of scheduled posts currently held by a pause.
- **Remove an approval workflow's default status**: Demote the workspace default, leaving the workspace with no default workflow until another is promoted.
- **Remove a social account**: Disconnect (remove) a connected social account from the workspace.
- **Remove a team member**: Remove a member from a workspace.
- **Remove the brand asset flag from media**: Clears the brand asset flag so the item no longer feeds AI generation.
- **Rename a media folder**: Renames a media-library folder.
- **Rename or recolour a tag**: Rename or recolour a tag
- **Results and spend grouped by campaign objective**: `results` means a different action per objective — reach for awareness, clicks for traffic, purchases for sales, and so on.
- **Resume publishing for a workspace**: Releases the hold on the workspace and returns held posts to the state the product returns them to.
- **Retry a failed report**: Retry a failed report
- **Run a schedule once, now**: Builds and sends this schedule's report immediately, exactly as its next scheduled run would - same report, same recipients.
- **Search a platform for an account to track as a competitor**: Search a platform for an account to track as a competitor
- **Search inbox elements**: Search inbox elements
- **Search terms with per-term metrics**: The actual queries people typed that triggered an ad, as opposed to the keywords bid on.
- **Send a DM (text, or media when a file is attached)**: Send a DM (text, or media when a file is attached)
- **Send approval invitations**: Enable the external-approval flow and email an approval link to each address.
- **Set an approval workflow as the workspace default**: Promote a workflow to the workspace default.
- **Set a team member's social account access**: Grant or revoke the social accounts a team member may use, in one call.
- **Set one analytics preference on an account**: Sets a single key.
- **Set, update or clear a note on media**: Writes a free-text note on a media item.
- **Shopping campaign product performance**: Per-product performance for Shopping campaigns.
- **Shuffle a category's queued posts**: Randomly reassign the execution times already held by this category's upcoming posts among those same posts.
- **Star a message (idempotent)**: Star a message (idempotent)
- **Submit a bulk post file**: Uploads a CSV of posts and queues it for processing.
- **Submit a video generation job**: Asynchronously submits text-to-video, image-to-video, or reference-to-video generation and returns a job handle immediately — the video is not ready yet.
- **Tabular breakdown of posting activity by type**: Tabular breakdown of posting activity by type
- **Threads account activity — the true per-day series**: What happened on each day ACROSS THE WHOLE ACCOUNT: profile views, likes, replies, reposts, quotes and link clicks.
- **Threads AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **Threads engagement trend by post publish date**: Engagement earned by the posts PUBLISHED on each day, measured at the last sync — not engagement that occurred on that day.
- **Threads follower demographics — age and gender**: A POINT-IN-TIME breakdown of the audience, not a range aggregate.
- **Threads follower demographics — country and city**: The same point-in-time breakdown as `demographics`, defaulting to the geographic dimensions instead of age and gender.
- **Threads follower trend, tracked since connection**: Daily follower totals assembled from the snapshots ContentStudio retained.
- **Threads posting cadence by hour of day**: A 24-element array indexed by hour, 00:00 to 23:00, bucketed in the requested timezone.
- **Threads posting cadence by weekday**: How many posts were published on each weekday, bucketed in the requested timezone rather than UTC — 'what day did this go out' only means anything in the poster's own clock.
- **Threads posts, paged and sorted for a table view**: The same rows as `top-posts` with a larger default page size (15) and an `offset` for paging.
- **Threads publishing behaviour and per-media-type breakdown**: The same daily series as `engagement`, plus a roll-up per media type and a `total` row.
- **Threads summary KPIs — current vs previous period**: Post totals for the period alongside the account-level totals for the same days.
- **Threads top hashtags — the tags the author typed**: Free-text hashtags parsed from the post text, ranked by engagement.
- **Threads top posts for the period**: Posts ranked by the requested metric, defaulting to total engagement.
- **Threads top topic tags — Meta's curated concept**: Threads topic tags ranked by engagement.
- **TikTok AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **TikTok daily engagement trend over time**: TikTok daily engagement trend over time
- **TikTok daily post volume and engagement breakdown over time**: TikTok daily post volume and engagement breakdown over time
- **TikTok follower and views trend over time**: TikTok follower and views trend over time
- **TikTok posts sorted by a configurable metric**: TikTok posts sorted by a configurable metric
- **TikTok summary KPIs — current vs previous period**: `avg_engagement_rate` is a percentage (engagement / views * 100).
- **TikTok top and least performing posts**: TikTok top and least performing posts
- **Top 5 posts per network for the selected campaigns & labels**: Same payload and response as the posts endpoint, except `limit` is ignored: this always returns 5 posts per selected network, merged and globally ordered by `sort_by`.
- **Top and least performing competitor posts (Facebook Competitors)**: Top and least performing competitor posts
- **Top and least performing competitor posts (Instagram Competitors)**: Top and least performing competitor posts
- **Twitter API credits usage for the workspace**: Twitter API credits usage for the workspace
- **Twitter engagement and impression trend over time**: Twitter engagement and impression trend over time
- **Twitter follower trend over time**: Twitter follower trend over time
- **Twitter summary KPIs — current vs previous period**: Twitter summary KPIs — current vs previous period
- **Twitter top-performing tweets**: Twitter top-performing tweets
- **Unhide a comment (idempotent)**: Unhide a comment (idempotent)
- **Unlike a comment (idempotent, Facebook)**: Unlike a comment (idempotent, Facebook)
- **Unstar a message (idempotent)**: Unstar a message (idempotent)
- **Update a campaign**: Update a campaign's name and/or color.
- **Update a content category**: Partially update a content category.
- **Update a label**: Update a label's name and/or color.
- **Update an approval workflow**: Partially update an approval workflow — fields that are not provided keep their current values.
- **Update an element's contact profile**: Update an element's contact profile
- **Update an existing social media post**: Update a post that has NOT been published yet.
- **Update an RSS automation**: Changes an existing automation's feed or settings.
- **Update a posting slot's day or time**: Partially update a slot — anything you omit keeps its current value.
- **Update a report schedule**: Update a report schedule
- **Update a saved competitor report**: Update a saved competitor report
- **Update a shareable analytics link**: Update a shareable analytics link
- **Update a shareable link**: Partially update a link — anything omitted keeps its value.
- **Update a team member**: Update a member's role and permissions.
- **Update a workspace**: Updates an existing workspace.
- **Upload media**: Upload a media file or import from URL into the workspace content library.
- **What a report can be built from**: The report types available and the sections each one can contain.
- **What Threads analytics can and cannot answer**: The authoritative, machine-readable list of which sections this platform serves and which metrics it cannot supply, each with a reason.
- **Which Bluesky metrics are available, and why the rest are not**: Machine-readable statement of what this platform can answer.
- **X (Twitter) AI insights**: X (Twitter) AI insights
- **YouTube AI-generated insights**: Two insight types over the same dataset, selected with `type`: `aiInsightsSummary` is a compact summary and `aiInsightsDetailed` is the full read-out.
- **YouTube audience demographics — age & gender, device type, subscriber change**: YouTube audience demographics — age & gender, device type, subscriber change
- **YouTube cumulative engagement trend over time**: YouTube cumulative engagement trend over time
- **YouTube cumulative subscriber trend over time**: YouTube cumulative subscriber trend over time
- **YouTube cumulative views split by subscriber / non-subscriber**: YouTube cumulative views split by subscriber / non-subscriber
- **YouTube cumulative watch time split by subscriber / non-subscriber**: YouTube cumulative watch time split by subscriber / non-subscriber
- **YouTube daily-delta engagement trend**: YouTube daily-delta engagement trend
- **YouTube daily-delta subscriber trend**: YouTube daily-delta subscriber trend
- **YouTube daily-delta views trend**: YouTube daily-delta views trend
- **YouTube daily-delta watch time trend**: YouTube daily-delta watch time trend
- **YouTube least-performing videos ordered by views and engagement**: Video metrics come from two YouTube APIs.
- **YouTube sharing platform breakdown**: YouTube sharing platform breakdown
- **YouTube summary KPIs — current vs previous period**: YouTube summary KPIs — current vs previous period
- **YouTube top geographies — countries pre-sorted by views, watch time, view duration and view percentage**: YouTube top geographies — countries pre-sorted by views, watch time, view duration and view percentage
- **YouTube top videos ordered by views and engagement**: Video metrics come from two YouTube APIs.
- **YouTube traffic source breakdown (how viewers found videos)**: YouTube traffic source breakdown (how viewers found videos)
- **YouTube video performance metrics grouped by publish date**: YouTube video performance metrics grouped by publish date
- **YouTube videos sorted by a configurable metric**: Video metrics come from two YouTube APIs.

Connect ContentStudio in General Input: https://www.generalinput.com/apps/contentstudio