← Todas las herramientas
EscrituraRequiere confirmación

Archivar sitio de trabajo

sites_archive

Retira reversiblemente un sitio de las nuevas faenas conservando referencias históricas.

Propósito

Cuándo usarla

Cuando necesites archivar sitio de trabajo.

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
organization_idstring (uuid)Obligatorio—
site_idstring (uuid)Obligatorio—
namestringObligatorio—
location_textstringOpcional—
approval_idstring (uuid)OpcionalAprobación humana vigente obtenida desde la página segura de Voltline

Ejemplo completo

Entrada
{
  "organization_id": "11111111-2222-4333-8444-555555555555",
  "site_id": "11111111-2222-4333-8444-555555555555",
  "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 empresa, membresía activa, grant del cliente y request ID antes de reintentar.

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