start_document_upload
Escribe un documento SUBIENDO UN ARCHIVO, sin que el contenido pase por el modelo. Es la forma rápida para contenido largo (más de ~20 KB) o que ya está en un archivo.
Devuelve `upload_url`. Subí el archivo (markdown o HTML) con UN comando y listo — el PUT escribe el documento:
curl -X PUT "<upload_url>" --data-binary @documento.md
La respuesta del curl trae el `resumen` (bytes, bloques, tablas, títulos, sha256): no hace falta llamar a nada más.
Con document_id: REEMPLAZA el contenido de ese documento (base_version opcional, igual que update_document).
Con name (sin document_id): crea un documento nuevo, ya, y la subida le pone el contenido.
El permiso vence en 2 horas y sirve para ese documento solo.Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_document_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Nombre de un documento NUEVO (sin document_id) | |
| document_id | No | Documento a reemplazar | |
| base_version | No | Con document_id: updated_at con el que se leyó | |
| workspace_id | No | UUID del workspace, o su nombre tal como lo dice el usuario ('Acme', 'el personal'). Omitir si el token ya tiene workspace fijo | |
| parent_document_id | No | Con name: documento padre del nuevo |