shareout_publish
Publish a new HTML document or revision. Returns version, published and conflict; a conflict retains the candidate without activation. Unpinned links follow the active version. Use the link tools for later link changes. Never pass document bytes.
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": {
"upload_id": "<upload_id>"
},
"name": "shareout_publish"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Version change note, not a sharing-link name. | |
| title | No | New document title; omit on revisions. | |
| expires | No | With link_label only; e.g. 14d, future ISO timestamp, or never if tier permits. | |
| upload_id | Yes | Hosted only: upload_id from a successfully transferred upload. | |
| link_label | No | Create a named bearer link with a NEW document only. | |
| visibility | No | New documents only: public, link (default), or private (sharing disabled). | |
| annotations | No | Embed the optional selection bridge in this stored version. | |
| document_id | No | Document to revise; hosted upload must target it. Omit to create. | |
| base_version | No | Required for revisions: current_version read before editing. |