API de Credenciales
Las credenciales se administran desde Studio o por API con la sesión de un administrador del Cliente.
Objeto Credencial
| Campo | Descripción |
|---|---|
id | Identificador. |
provider | infernode, anthropic, gemini, openrouter, saptiva, s3, whatsapp, mcp. |
name | Nombre visible; es lo que referencian agentes y flujos. |
isDefault | Si es la predeterminada de su proveedor. |
sharedWithOrg | Si toda la organización puede usarla. |
managedBy | user, organization o system. Las de infernode son de organización. |
updatedAt | Última modificación. |
Los valores secretos nunca se devuelven en las lecturas.
Operaciones
- Listar credenciales del Cliente con su estado (
connected,unconfigured). - Crear: proveedor, nombre y los campos del proveedor (por ejemplo, para S3: endpoint, región, llave, secreto, bucket y URL pública opcional). El servicio valida contra el proveedor antes de guardar.
- Editar: los campos secretos vacíos conservan el valor actual. Es la forma de rotar sin cambiar referencias.
- Compartir con la organización y dejar de compartir.
- Marcar como predeterminada.
- Eliminar. Irreversible; los agentes y flujos que la usaban pasan a
needs_attention.
Errores
| HTTP | Cuándo |
|---|---|
| 403 | El usuario no es administrador del Cliente. |
| 422 | El proveedor rechazó las credenciales. |
| 503 | El almacén de secretos no está disponible. |
Rutas exactas en el OpenAPI de tu instalación.