Skip to content
Ishvana Ishvana Docs

Start Studio Session

POST
/api/creative/marketing/studio/start

Start a creative studio debate, streaming NDJSON events.

Request Body required

Section titled “Request Body required ”
StartStudioRequest

Request to start a creative studio session.

object
prompt
required
Prompt

The marketing strategy question

string
assetIds
Assetids

Existing asset IDs for context

Array<string>
includeBrief
Includebrief
boolean
default: true
includeIntel
Includeintel
boolean
default: true
members
Any of:
Array<object>
StudioMemberConfig

Configuration for a creative studio council member.

object
id
required
Id

Member identifier

string
name
required
Name

Display name

string
role
required
Role

Role description

string
systemPrompt
required
Systemprompt

System prompt for the LLM

string
personality
required
StudioMemberPersonality

Personality traits controlling debate behavior (0-100 each).

object
creativity
Creativity
integer
default: 50 <= 100
detail
Detail
integer
default: 50 <= 100
formality
Formality
integer
default: 50 <= 100
collaboration
Collaboration
integer
default: 50 <= 100
riskTaking
Risktaking
integer
default: 50 <= 100
expertiseAreas
Expertiseareas
Array<string>
maxRounds
Maxrounds
integer
default: 3 >= 1 <= 10
allowEarlyConsensus
Allowearlyconsensus

Let the moderator end the debate early if consensus is overwhelming

boolean
moderatorDepth
ModeratorDepth

How detailed the moderator’s round summaries should be

string
default: standard
Allowed values: brief standard thorough

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object