MB SuiteMB Suite
Menú

Referencia de la API · Content Studio

Sesiones de fotos

social_content_studio · photo_sessions · 2 operaciones

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

LecturaIdempotenteDesde 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.

Alcance
social_content_studio:read
Permiso
Ver el módulo
Tool del MCP
social_content_studio_photo_sessions_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_content_studio.photo_sessions.list".

Costo declarado: hasta 401 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

limitintegerqueryopcional

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

Por defecto: 50

cursorstringqueryopcional

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

statusenumqueryopcional

Only sessions in this status: draft, generating, completed, partial.

Valores: draft, generating, completed, partial

include_archivedbooleanqueryopcional

Also archived sessions. Default false.

Por defecto: false

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

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

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

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

LecturaIdempotenteDesde 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.

Alcance
social_content_studio:read
Permiso
Ver el módulo
Tool del MCP
social_content_studio_photo_sessions_getEn la superficie completa; en la compacta, mb_execute_operation con id: "social_content_studio.photo_sessions.get".

Costo declarado: hasta 1 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

session_idstringrutarequerido

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

Respuesta

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

Errores

photo_session_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

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

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

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