Overview
The two ways to drive a Permaura gateway without the console — the permaura CLI and the REST v1 API.
The permaura CLI
permaura is the command-line control surface for the Permaura gateway — manage agents, grants, secrets, policy and connections over the REST v1 API.
Command reference
Every permaura subcommand — start, stop, upgrade, init, status, agents, grants, vault, audit, approvals, policy and connections.
Running it with npx
Install and run the Permaura gateway with one command using the permaura npm package — the same binary, fetched on demand.
REST API
The gateway's operator-plane HTTP API — authentication, conventions, the full route list, and the two behaviours that surprise people.
Worked example: Paddle
Add a Paddle (sandbox) connection by driving the gateway's REST API directly — OpenAPI import, credential sealing, policy gating, approvals, and the kill switch, end to end.