← Todas las herramientas
EscrituraRequiere confirmación

Invitar operador de plataforma

platform_invite_user

Crea o reutiliza una cuenta y envía la invitación por correo; el enlace nunca pasa por el modelo.

Propósito

Cuándo usarla

Cuando necesites invitar operador de plataforma.

Cuándo no usarla

No la uses sin una solicitud humana clara, grant de escritura y revisión del alcance.

Parámetros de entrada

ParámetroTipoRequisitoDetalle
emailstring (email)Obligatorio—
full_namestringObligatorio—
roleplatform_admin | platform_editorOpcionaldefault: platform_editor
approval_idstring (uuid)OpcionalAprobación humana vigente obtenida desde la página segura de Voltline

Ejemplo completo

Entrada
{
  "email": "persona@empresa.cl",
  "full_name": "Ejemplo operativo"
}
Salida
{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "result": "Respuesta resumida de Voltline"
  }
}

Errores y recuperación

authentication_required

Reconecta Voltline mediante OAuth.

mcp_tool_grant_required

Confirma una conexión global de platform_admin activa y vuelve a intentar con el request ID.

organization_scope_mismatch

Selecciona una empresa incluida en la conexión.

internal_error

Entrega el request ID a soporte; no reenvíes tokens ni archivos.

Auditoría

Se registra

  • ✓request ID
  • ✓usuario y cliente OAuth
  • ✓empresa y herramienta
  • ✓resultado, duración y hash de argumentos

Nunca se registra

  • ×token
  • ×prompt completo
  • ×URL firmada
  • ×archivo
  • ×contraseña