Listar grupos de conexiones
Lista grupos del panel. 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.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/conexiones.grupos.listar/execute" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "revision": -9007199254740991, "grupos": [ { "id": "string", "nombre": "string", "icono": "folder", "color": "neutral", "conexionIds": [ "string" ] } ], "sinGrupo": [ "string" ] }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Crear grupo de conexiones POST
Crea un grupo vacío. Queda al final del menú de conexiones de la organización. El nombre es único sin distinguir mayúsculas: si ya existe un grupo con el mismo nombre, icono y color, lo devuelve sin crear otro; si existe con otro icono o color, falla. Exige una credencial con acceso a todas las conexiones. Para llenarlo usa conexiones.grupos.mover.
Mover conexión de grupo POST
Mueve una conexión. La deja al final del grupo indicado, o sin grupo con 'grupoId' en null. No cambia ninguna otra conexión ni grupo. Si ya estaba en ese destino, no cambia nada y responde 'cambiada' en false. Los ids salen de conexiones.grupos.listar y de conexiones.estado.consultar.