Share something
shareShares a thing (a doc, note, sheet, file, folder, task, goal, Kairo answer or chat) with people by email or handle, with a note and what is needed from them. Workspace members get it in Coline. People outside get an email with a link that needs no account; when an assistant or agent shares outside the workspace, it waits for the person's OK in Coline. Use it only when the person asks to share something with someone.
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": {
"workspace": "<workspace>",
"kind": "<kind>",
"targetId": "<targetId>"
},
"name": "share"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ask | No | What the sender needs: nothing, feedback, an approval, an answer, a time to meet, or a task done. | |
| kind | Yes | What is shared. For any Drive file, "file" works: the file's own type is used. | |
| note | No | ||
| people | No | ||
| options | No | ||
| targetId | Yes | ||
| askDetail | No | ||
| workspace | Yes | Workspace slug from workspaces.list, e.g. "acme". | |
| linkAccess | No | "anyone": anyone with the link can view it. | |
| targetSubId | No | A Kairo answer: the answer's message id. | |
| answerOptions | No | For an answer: the choices. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | Yes | True when people outside wait for the person's OK in Coline. | |
| added | Yes | ||
| draft | Yes | ||
| pageUrl | Yes | ||
| shareId | Yes |