Create study

create_study Requires studies:write

Brief Juno to create a research study from plain-language guidance: describe what the user wants to learn, and Juno designs the interview — objectives, screener questions, and the questions the interviewer will ask. When documents are part of the brief, upload them over REST first and pass their file_ids here. Authoring runs in the background: returns a job handle; poll get_authoring_status until the study and its brief are ready. New studies start in Test mode so the user can simulate the interview shape before Go live. Test mode uses no credits, provides no analysis or exports, and is not for real participants.

Input

guidance

string required

Plain-language instruction from the user: the research goal, intended participants, and what the user wants to learn — or, when updating, what to change. A sentence or two is enough.

file_ids

array | null

Optional file ids from POST /v1/api/files. Include them when documents are part of Create a study or Update a study.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_study",
    "arguments": {
      "guidance": "Interview 10 recent churned customers about why they cancelled.",
      "file_ids": null
    }
  }
}