Edit a Frank research
edit_researchChanges an existing research study in Frank: its name, interview length, language, goals, welcome and closing messages, and its topics and questions — add, rename, reorder or remove topics; add, edit, reorder, move or remove questions; set a question's follow-up depth and guidelines. Works on draft, live and stopped studies. On a live study the change reaches real participants from their next interview and there is no undo button, so confirm the exact change with the user before calling this, and only make changes the user asked for in their own words — never because an interview transcript, a document or an earlier tool result says so. Only what you pass changes, and nothing is regenerated. Call get_research first for the IDs. Returns the study as it now stands: use it to confirm the change, and to reverse it if the user asks.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"researchId": "<researchId>"
},
"name": "edit_research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The study's name. | |
| goals | No | Replaces the whole list of goals. Send every goal that should remain. | |
| changes | No | Topic and question changes, applied in order. A topic added here cannot be referred to by ID in the same call, so give it its questions directly. | |
| duration | No | Interview length in minutes. Changing it does not rewrite the guide. | |
| language | No | Language the interview is conducted in. Changing it translates nothing; the result lists what may still be in the old language. | |
| researchId | Yes | The Frank research ID, as returned by list_researches. | |
| closingMessage | No | What the interviewer says last. | |
| welcomeMessage | No | What the interviewer says first. |