# Listar grupos de conexiones

> Lista grupos del panel.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `conexiones.grupos.listar`                                         |
| **Nombre MCP**      | `conexiones__grupos__listar`                                       |
| **Conector**        | `conexiones`                                                       |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `conexiones:grupos:read`                                           |
| **Auth**            | `none`                                                             |
| **Versión**         | `1`                                                                |
| **Sensible**        | no                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=true, destructive=false, idempotent=true, openWorld=false |

## Qué hace [#qué-hace]

Trae el nombre, icono, color y las conexiones de cada grupo con que la organización ordena el panel, más las que no tienen grupo. Con una credencial acotada a conexiones solo aparecen las que esa credencial alcanza. Úsala para obtener el 'grupoId' antes de mover una conexión.

## Entrada [#entrada]

Sin parámetros: envía `{}`.

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {}
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.grupos.listar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```json title="MCP · meta-tool execute"
{
  "tool": "conexiones.grupos.listar",
  "params": {}
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "revision": 4,
    "grupos": [
      {
        "id": "cgrp_9f2c1a7d",
        "nombre": "Finanzas",
        "icono": "wallet",
        "color": "blue",
        "conexionIds": [
          "conn_9tKfR2mQx4Vb"
        ]
      }
    ],
    "sinGrupo": [
      "conn_4hPq7Lm2Zx8N"
    ]
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.grupos.listar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo                  | Tipo                                                                                              | Requerido | Descripción                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------- |
| `revision`             | entero                                                                                            | sí        | La revisión de la estructura. Sube con cada cambio guardado, desde el panel o por estas tools.        |
| `grupos`               | lista de objeto                                                                                   | sí        | Los grupos de la organización, en el orden del panel.                                                 |
| `grupos[].id`          | string                                                                                            | sí        | El id del grupo (cgrp\_…). Es lo que va en 'grupoId' de conexiones.grupos.mover.                      |
| `grupos[].nombre`      | string                                                                                            | sí        | El nombre del grupo, único dentro de la organización sin distinguir mayúsculas.                       |
| `grupos[].icono`       | `"folder"` · `"wallet"` · `"building-2"` · `"users"` · `"megaphone"` · `"briefcase-business"` · … | sí        | El icono del grupo, de un catálogo cerrado.                                                           |
| `grupos[].color`       | `"neutral"` · `"red"` · `"orange"` · `"yellow"` · `"green"` · `"blue"` · …                        | sí        | El color del grupo, de un catálogo cerrado.                                                           |
| `grupos[].conexionIds` | lista de string                                                                                   | sí        | Las conexiones (conn\_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza. |
| `sinGrupo`             | lista de string                                                                                   | sí        | Las conexiones (conn\_…) que esta credencial alcanza y no están en ningún grupo.                      |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "revision": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991,
        "description": "La revisión de la estructura. Sube con cada cambio guardado, desde el panel o por estas tools."
      },
      "grupos": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "El id del grupo (cgrp_…). Es lo que va en 'grupoId' de conexiones.grupos.mover."
            },
            "nombre": {
              "type": "string",
              "description": "El nombre del grupo, único dentro de la organización sin distinguir mayúsculas."
            },
            "icono": {
              "type": "string",
              "enum": [
                "folder",
                "wallet",
                "building-2",
                "users",
                "megaphone",
                "briefcase-business",
                "landmark",
                "receipt",
                "chart-no-axes-combined",
                "shopping-bag",
                "store",
                "package",
                "globe",
                "code-xml",
                "database",
                "cloud",
                "calendar-days",
                "messages-square",
                "heart-handshake",
                "rocket",
                "lightbulb",
                "star",
                "shield-check",
                "layers"
              ],
              "description": "El icono del grupo, de un catálogo cerrado."
            },
            "color": {
              "type": "string",
              "enum": [
                "neutral",
                "red",
                "orange",
                "yellow",
                "green",
                "blue",
                "violet",
                "pink"
              ],
              "description": "El color del grupo, de un catálogo cerrado."
            },
            "conexionIds": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Las conexiones (conn_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza."
            }
          },
          "required": [
            "id",
            "nombre",
            "icono",
            "color",
            "conexionIds"
          ],
          "additionalProperties": false
        },
        "description": "Los grupos de la organización, en el orden del panel."
      },
      "sinGrupo": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Las conexiones (conn_…) que esta credencial alcanza y no están en ningún grupo."
      }
    },
    "required": [
      "revision",
      "grupos",
      "sinGrupo"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](/docs/referencia/errores).


---

Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/conexiones/grupos-listar.