> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marina.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAPI

> Connect to an HTTP API described by an OpenAPI document.

## Setup

Provide the URL of a JSON OpenAPI document, an optional base URL, and the API's credential (bearer token, API key in a header or query parameter, or username and password). List the operationIds apps may call; only GET operations are callable.

Add the connection under **Settings -> Connections**. Saving verifies it with a read-only test call.

## Allowlist

Apps can call only the operationIds listed in the connection's configuration, and only when the operation is a GET.

## Operations

All operations are read-only. Apps declare the ones they use per connection; see [Using connections in apps](/connections/overview).

| Operation | Description |
| - | - |
| `operations.list` | List the document's operations, marking which are approved and read-only. |
| `operation.call` | Call one approved GET operation by its operationId. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.