Skip to content
General Augment Docs

Connect Your API

Terminal window
genaug capability import openapi orders \
  --spec ./orders.openapi.json \
  --operation listOrders=orders.read \
  --operation cancelOrder=orders.cancel \
  --credential orders-api \
  --wait


genaug credential set orders-api --from-env ORDERS_API_KEY

General Augment reads or fetches the specification once, validates it, stores the exact bytes as a content-addressed asset, and freezes the selected operation schemas. Credential values remain in the vault and never enter source or Agent context.

Grant only the operations an Agent needs:

Terminal window
genaug agent capability grant support orders.read --wait
genaug capability test orders.read
genaug agent test support --user customer_123 --json

Write operations should call an app-owned authorization boundary or require an exact approval. An Agent never receives the entire imported API implicitly.