MB SuiteMB Suite
Menu

API reference · Content Studio

Photo sessions

social_content_studio · photo_sessions · 2 operations

GET/v1/social-content-studio/photo-sessionsGET/v1/social-content-studio/photo-sessions/{session_id}
GET/v1/social-content-studio/photo-sessions

List photo sessions

social_content_studio.photo_sessions.list

ReadIdempotentSince 2026-11-01

Lists the organization's product photo sessions (AI product photography from the customer's own product pictures), newest first, paginated by cursor (limit up to 200). Each item is a summary: name, status (draft, generating, completed, partial), session type (studio, scene, action, flat_lay, with_model, detail), mode (mono: one product in several variations; multi: several products in the same style), output formats, product count, generated image count and the Media Library folder that holds the photos. The products and their images come with social_content_studio.photo_sessions.get. Archived sessions 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). Requires view access to Content Studio.

Scope
social_content_studio:read
Permission
View the module
MCP tool
social_content_studio_photo_sessions_listOn the full surface; on the compact one, mb_execute_operation with id: "social_content_studio.photo_sessions.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 sessions in this status: draft, generating, completed, partial.

Values: draft, generating, completed, partial

include_archivedbooleanqueryoptional

Also archived sessions. Default false.

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/photo-sessions" \
  -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/photo-sessions" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/social-content-studio/photo-sessions/{session_id}

Get one photo session

social_content_studio.photo_sessions.get

ReadIdempotentSince 2026-11-01

Returns one photo session with its settings (type, mode, reference mode, formats, logo) and its products, each with its status and the generated images (format, image URL, storage path, Media Library item id, variation number, and the instruction when it is a variant of another image). Image URLs are MB Suite storage paths, relative to the app (/api/v1/storage/resolve?key=…). Not found for an id of another organization. Requires view access to Content Studio.

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

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

Parameters

session_idstringpathrequired

The photo session id (from social_content_studio.photo_sessions.list).

Response

idstring
namestring
statusstring

draft, generating, completed or partial.

session_typestring | null

studio, scene, action, flat_lay, with_model or detail.

modestring | null

mono (one product, several variations) or multi (several products, same style).

reference_modestring | null

replicate, inspire or free (no reference).

formatsarray<string> | null

feed, portrait, story, landscape, ultrawide.

logo_optionstring | null

logo, icon or none.

variation_countnumber | null

Mono mode: how many variations.

product_countnumber | null
generated_image_countnumber | null
total_credits_consumednumber | null

AI credits the session has used.

media_folder_idstring | null

The Media Library folder where its photos are saved.

is_archivedboolean | null
archived_atnumber | null
batch_statestring | null
created_bystring | null

Uid of the person who created it.

created_atnumber | null
updated_atnumber | null
scene_descriptionstring | null
model_descriptionstring | null
detail_descriptionstring | null
elements_descriptionstring | null
reference_image_urlstring | null

The style reference photo.

generation_started_atnumber | null
productsarray<object> | null

Errors

photo_session_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-content-studio/photo-sessions/{session_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/photo-sessions/{session_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"