Update study

refine_study Requires studies:write

Update a study with further plain-language instructions from the user, in Test mode or Live mode. The refine_study tool name is retained for wire compatibility. When new documents are part of the update, upload them over REST first and pass their file_ids here. Each update creates a new design version and returns a job handle; poll get_authoring_status.

Input

study_id

string required

guidance

string required

file_ids

string[] · nullable

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "refine_study",
    "arguments": {
      "study_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "guidance": "Interview 10 recent churned customers about why they cancelled.",
      "file_ids": null
    }
  }
}