Replace a document
update_shareReplace the content of a document this agent owns. The link stays the same. Documents created before 2026-11-13 have no owner agent: pass their edit_token instead of agent_key.
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": {
"id": "<id>",
"content": "<content>"
},
"name": "update_share"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The document id (e.g. calm-river-Ab12C) or any docs-md.com URL of it. | |
| content | Yes | The markdown, 1 to 120,000 characters. Public to anyone with the link: no secrets. | |
| filename | No | Shown as the page title, e.g. "HANDOFF.md". ".md" is appended if missing. | |
| agent_key | No | The owner agent's key. Required unless edit_token is given. | |
| edit_token | No | Only for documents created before 2026-11-13: the edit token returned when the share was created. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | Yes | ||
| shape | Yes | ||
| notices | Yes | Plain sentences about anything the server adjusted. | |
| indexable | Yes | ||
| updated_at | Yes | ISO 8601 time, UTC. | |
| links_clickable | Yes |