MB SuiteMB Suite
Menu

Referência da API · Content Studio

Sessões de fotos

social_content_studio · photo_sessions · 2 operações

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

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

Escopo
social_content_studio:read
Permissão
Ver o módulo
Tool do MCP
social_content_studio_photo_sessions_listNa superfície completa; na compacta, mb_execute_operation com id: "social_content_studio.photo_sessions.list".

Custo declarado: até 401 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

limitintegerqueryopcional

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

Padrão: 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.

Padrão: false

Resposta

dataarray<object>
has_moreboolean
next_cursorstring

Erros

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode 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

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

Escopo
social_content_studio:read
Permissão
Ver o módulo
Tool do MCP
social_content_studio_photo_sessions_getNa superfície completa; na compacta, mb_execute_operation com id: "social_content_studio.photo_sessions.get".

Custo declarado: até 1 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

session_idstringrotaobrigatório

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

Resposta

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

Erros

photo_session_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

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