Crea y administra Powers por API

Todo lo que puedes hacer desde el panel para configurar un Power tiene su equivalente en la API: crearlo, listarlo, editarlo y borrarlo. Para integraciones que provisionan Powers de forma dinámica —un onboarding que arma la configuración inicial de cada cliente, por ejemplo— es la vía por la que automatizas lo que de otro modo sería trabajo manual repetido.

Crear un Power

Crear un Power pide un nombre, una descripción —la que le dice al modelo cuándo usarlo, hasta 500 caracteres—, la url validada como pública y segura por https, el método —GET por defecto si no lo indicas— y, si el webhook lo necesita, una cabecera de autenticación con su clave y su valor. Los parámetros van en el mismo cuerpo, cada uno con su nombre, su descripción y si es obligatorio.

El listado no trae todo

El listado de Powers devuelve nombre, descripción, url y método de cada uno, pero no la cabecera ni los parámetros —esos solo aparecen en el detalle. Si tu integración necesita inspeccionar la configuración completa de un Power, no te alcanza con el listado: pide el detalle de cada uno que te interese.

Editar parámetros es un diff, no un reemplazo simple

• Un parámetro con id en el cuerpo de la actualización: se edita.
• Un parámetro con id y nombre en null: se elimina.
• Un parámetro sin id: se crea como nuevo.

Eso significa que puedes actualizar, borrar y crear parámetros en una sola llamada, sin tener que hacer tres peticiones separadas ni recalcular tú mismo qué cambió.

El límite de parámetros se valida sobre el resultado final

Si tu actualización borra tres parámetros y crea cinco nuevos en la misma llamada, la capacidad de parámetros se evalúa sobre el conteo que queda después de aplicar todos los cambios, no sobre cada operación por separado. Puedes reorganizar libremente mientras el total final se mantenga dentro de lo que tu plan permite.

Borrar un Power no rompe a los agentes que lo usaban

Eliminar un Power borra el propio Power, sus parámetros y sus vínculos con cualquier agente que lo tuviera conectado —pero los agentes en sí permanecen intactos, simplemente con una herramienta menos. Es un borrado seguro de ejecutar sin coordinar antes con quien administra los agentes.