Purpose
When to use it
Invite or reuse a platform account without exposing the email link to the model. 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 |
|---|---|---|---|
email | string (email) | Required | — |
full_name | string | Required | — |
role | platform_admin | platform_editor | Optional | default: platform_editor |
approval_id | string (uuid) | Optional | Aprobación humana vigente obtenida desde la página segura de Voltline |
Complete example
Input
{
"email": "persona@empresa.cl",
"full_name": "Ejemplo operativo"
}Output
{
"ok": true,
"requestId": "req_01JEXAMPLE",
"data": {
"result": "Respuesta resumida de Voltline"
}
}Errors and recovery
authentication_requiredReconecta Voltline mediante OAuth.
mcp_tool_grant_requiredConfirma una conexión global de platform_admin activa y vuelve a intentar con el request ID.
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