MB SuiteMB Suite
Menu

API reference · Content Studio

Series

social_content_studio · series · 2 operations

GET/v1/social-content-studio/seriesGET/v1/social-content-studio/series/{series_id}
GET/v1/social-content-studio/series

List Content Studio series

social_content_studio.series.list

ReadIdempotentSince 2026-11-01

Lists the organization's Content Studio social series (AI-generated sets of image posts), newest first, paginated by cursor (limit up to 200). Each item is a summary: name, topic, status (planning, generating, review, scheduled, partial, failed), networks, planned and generated post counts, art_mode (ai, or manual for the Social Planner's content plans, which also show here), created_via, and the ids of the Social Planner posts it scheduled; the plan and the posts come with social_content_studio.series.get. Archived series are left out unless include_archived=true. status and archive are applied reading on until the page is full (up to 400 read per call), so a page brings fewer than limit only with has_more true at that limit: keep following next_cursor. Ad Creator creatives are not listed. Requires view access to Content Studio.

Scope
social_content_studio:read
Permission
View the module
MCP tool
social_content_studio_series_listOn the full surface; on the compact one, mb_execute_operation with id: "social_content_studio.series.list".

Declared cost: up to 401 reads and 0 writes per call (they count against the daily quota).

Parameters

limitintegerqueryoptional

How many items this page brings at most (see the maximum and the default in the schema).

Default: 50

cursorstringqueryoptional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

statusenumqueryoptional

Only series in this status: planning, generating, review, scheduled, partial, failed.

Values: planning, generating, review, scheduled, partial, failed

include_archivedbooleanqueryoptional

Also archived series. Default false: only active ones.

Default: false

Response

dataarray<object>
has_moreboolean
next_cursorstring

Errors

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-content-studio/series" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/social-content-studio/series" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/social-content-studio/series/{series_id}

Get one Content Studio series

social_content_studio.series.get

ReadIdempotentSince 2026-11-01

Returns one Content Studio series with its topic plan (topic_plan: one entry per planned post with its headline, format and settings) and its generated posts (posts: image URLs, carousel slides, per-network copies with hashtags, status). A completed post can come without copy (copies empty): its image is done and copies_error says why (ai_credits_exhausted or ai_personal_limit: no AI credits for the person who launched the series; payment_required: the subscription that pays the AI credits is blocked; generation_failed: the AI could not write it); the copy can be written later in the app. A post already sent to the Social Planner shows its planner state read at this moment (scheduled, publishing, published, partially_published, publish_failed, or post_deleted if it was removed from the planner), with planner_post_id to open it with social_planner.posts.get. Image URLs are MB Suite storage paths, relative to the app (/api/v1/storage/resolve?key=…). Not found for an id of another organization or an Ad Creator creative. Requires view access to Content Studio.

Scope
social_content_studio:read
Permission
View the module
MCP tool
social_content_studio_series_getOn the full surface; on the compact one, mb_execute_operation with id: "social_content_studio.series.get".

Declared cost: up to 31 reads and 0 writes per call (they count against the daily quota).

Parameters

series_idstringpathrequired

The series id (from social_content_studio.series.list).

Response

idstring
namestring
statusstring

planning, generating, review, scheduled, partial or failed.

topicstring | null

What the series is about, as its author described it.

contextstring | null

social (Content Studio series are always social; Ad Creator's paid-media series are another module).

platformsarray<string> | null

The networks the series writes copy for.

post_countnumber | null

How many posts the series plans.

approved_countnumber | null

Posts approved in the review.

generated_image_countnumber | null

Images generated so far.

total_credits_consumednumber | null

AI credits the series has used (plan, copy and images).

art_modestring | null

ai (the series generates the images) or manual (a plan without art: the designer makes it).

created_viastring | null

wizard (Content Studio); chat_plan and csv_import are Social Planner content plans (social_planner.plans.*).

objectivestring | null

awareness, engagement, conversion or community.

frequencystring | null

daily, 3_per_week, 2_per_week, weekly or custom (then custom_days).

is_archivedboolean | null

Archived by a person: only hidden from Content Studio's default view; what is scheduled still publishes.

archived_atnumber | null

When it was archived (ms epoch).

batch_statestring | null

While generating through the batch queue: queued or running.

scheduled_atnumber | null

When the series was sent to the Social Planner (ms epoch).

post_idsarray<string> | null

The Social Planner posts the series created.

created_bystring | null

Uid of the person who created it.

created_atnumber | null
updated_atnumber | null
custom_daysarray<number> | null

With frequency custom: the weekdays (0 = Sunday … 6 = Saturday).

content_languagestring | null

The language variant the copy is written in.

generation_started_atnumber | null

When the last generation started (ms epoch).

topic_planarray<object> | null

The plan: one topic per post.

postsarray<object> | null

The generated posts, with the status their Social Planner post has today.

Errors

series_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-content-studio/series/{series_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/social-content-studio/series/{series_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"