Purpose
When to use it
Create a short-lived session for a person to upload a file directly to Voltline. Use it only within the authorized organization.
When not to use it
Do not use it for another organization, a different action, or to bypass a confirmation.
Input parameters
| Parameter | Type | Requirement | Details |
|---|---|---|---|
organization_id | string (uuid) | Optional | — |
purpose | procedure_pdf | norm_pdf | faena_evidence | Required | — |
original_name | string | Required | — |
mime_type | application/pdf | image/jpeg | image/png | image/webp | Required | — |
size_bytes | integer | Required | — |
Complete example
Input
{
"purpose": "procedure_pdf",
"original_name": "procedimiento.pdf",
"mime_type": "application/pdf",
"size_bytes": 240000
}Output
{
"ok": true,
"requestId": "req_01JEXAMPLE",
"data": {
"uploadId": "11111111-2222-4333-8444-555555555555",
"uploadPage": "https://app.voltline.cl/es/mcp/uploads/11111111-2222-4333-8444-555555555555",
"expiresInSeconds": 900
}
}Errors and recovery
invalid_upload_metadataCorrige nombre, MIME o tamaño.
mcp_write_grant_requiredHabilita archivos en la conexión.
Audit
Recorded
- ✓upload ID
- ✓finalidad
- ✓MIME
- ✓tamaño
- ✓hash al completar
Never recorded
- ×contenido del archivo
- ×token OAuth
- ×URL firmada en auditoría