Purpose
When to use it
Invite a person to an organization without exposing credentials 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 |
|---|---|---|---|
organization_id | string (uuid) | Required | — |
email | string (email) | Required | — |
full_name | string | Required | — |
role | org_admin | org_lead | inspector | Required | — |
locale | es | en | Optional | default: es |
Complete example
Input
{
"organization_id": "11111111-2222-4333-8444-555555555555",
"email": "persona@empresa.cl",
"full_name": "Ejemplo operativo",
"role": "org_admin"
}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