← All tools
Read only

List sites

sites_list

List active sites and, when requested, archived sites for an organization.

Purpose

When to use it

List active sites and, when requested, archived sites for an organization. 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

ParameterTypeRequirementDetails
organization_idstring (uuid)Required—
include_archivedbooleanOptionaldefault: false

Complete example

Input
{
  "organization_id": "11111111-2222-4333-8444-555555555555"
}
Output
{
  "ok": true,
  "requestId": "req_01JEXAMPLE",
  "data": {
    "result": "Respuesta resumida de Voltline"
  }
}

Errors and recovery

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.

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