Purpose
When to use it
Update a live field-work step as pending, complete, or blocked, with notes. 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) | Required | — |
faena_id | string (uuid) | Required | — |
template_step_id | string (uuid) | Required | — |
state | pending | done | blocked | Required | — |
value_bool | any | Optional | — |
value_num | any | Optional | — |
value_text | any | Optional | — |
notes | any | Optional | — |
Complete example
Input
{
"organization_id": "11111111-2222-4333-8444-555555555555",
"faena_id": "11111111-2222-4333-8444-555555555555",
"template_step_id": "11111111-2222-4333-8444-555555555555",
"state": "pending"
}Output
{
"ok": true,
"requestId": "req_01JEXAMPLE",
"data": {
"result": "Respuesta resumida de Voltline"
}
}Errors and recovery
authentication_requiredReconecta Voltline mediante OAuth.
mcp_tool_grant_requiredConfirma empresa, membresía activa, grant del cliente y request ID antes de reintentar.
organization_scope_mismatchSelecciona una empresa incluida en la conexión.
internal_errorEntrega el request ID a soporte; no reenvíes tokens ni archivos.
Audit
Recorded
- ✓request ID
- ✓usuario y cliente OAuth
- ✓empresa y herramienta
- ✓resultado, duración y hash de argumentos
Never recorded
- ×token
- ×prompt completo
- ×URL firmada
- ×archivo
- ×contraseña