Save a draft
save_draftSaves an article you wrote in the project's Writing Assistant, where the user reads and edits it: a new draft, with a title and optionally a content template to score it against, or an update of a draft you read with get_saved_drafts. An update passes the draft's updatedAt as you read it and is refused if the draft was saved since, so a person's edits are never written over: read it again and save your changes onto that text. get_saved_drafts lists it as saved by an agent, also after a person edits it. Returns the draft's id, its link in the app, its new updatedAt, and its match with the top pages out of 100 against its template with what to do next, from the Writing Assistant's own measure. Uses no credits and calls no provider. A template from another project is refused.
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": {
"projectId": "<projectId>",
"text": "<text>"
},
"name": "save_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The whole article, which replaces the draft's text on an update. Plain text, each subheading on its own line starting with '## ' ('### ' one level below), as the Writing Assistant scores it. | |
| title | No | The draft's title. Needed for a new draft; an update keeps the draft's title when it is omitted. | |
| draftId | No | The draft to update, from get_saved_drafts. Omit to save a new draft. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| updatedAt | No | With draftId, required: the draft's updatedAt exactly as get_saved_drafts or save_draft last returned it. The update is refused if the draft was saved since, so what a person wrote in the app is never written over. | |
| templateId | No | The id of one of this project's content templates, from get_saved_content_template, to score the draft against. A new draft without one is not scored; an update keeps the draft's template when it is omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| draft | Yes | ||
| created | Yes |