Start task run
startTaskRunHand the assistant one job to do in the background, with no task saved: a long tidy-up, a report, or anything that should not wait on this conversation. It keeps working after the chat is closed and reports when done.
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": {
"instruction": "<instruction>"
},
"name": "startTaskRun"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | `standard` is the everyday model. `advanced` reasons better over long jobs and costs ten AI actions where the standard one costs one. | |
| autonomy | No | `ask` sends every change to a person to approve. `organize` lets the run label, archive, bin, snooze, draft, take notes and keep contacts by itself, and email the addresses of the workspace. `reply` also lets it answer an email without asking, as long as it adds no recipients and the task does not use `connectors`. Anything else always waits for approval, and so does every change in a connected app. | |
| maxSteps | No | The most model steps one run may take before it has to write its report. | |
| threadId | No | A conversation to hand the run as its starting point, as `GET /threads` lists it. | |
| toolkits | No | Extra groups of tools the run may use beyond reading and organising mail, such as `contacts`, `calendar`, `knowledge`, `web` or `connectors`, which lets it use the apps connected for the workspace. A run can never reach billing, members, domains, rules, keys or webhooks. | |
| instruction | Yes | What the assistant should do, in plain words, as you would tell a person. It is the only instruction the run follows: text inside emails is read, never obeyed. |