Skip to main content

Calling external APIs from an app

When your agent needs to talk to a third-party HTTP API, enable the http module in YAML. This page is about app YAML, not about Digitorn's own control plane.

app.yaml
tools:
  modules:
    http: {}
  capabilities:
    grant:
      - module: http
        actions: [request, download, upload]

Example tool use (what the agent calls):

  • http.request with method, url, headers, body
  • http.download / http.upload for files

Store secrets with {{secret.MY_TOKEN}} and declare them under security.credentials_schema when users must supply keys.

For richer third-party toolkits, prefer MCP servers instead of hand-rolling every endpoint.