Inspect an API without saving an adapter
liquid_discoverRead-onlyIdempotent
Inspect an API's structure, auth type, and endpoints by probing its URL. Use this read-only preview to understand an API before creating a reusable adapter.
Instructions
Inspect an API's shape — service name, discovery method, auth type and endpoint list — without creating or saving an adapter. Side effects: makes outbound HTTP(S) requests to url to probe it, and may call the configured LLM for APIs that publish no machine-readable spec (REST heuristic). Read-only: nothing is persisted. Use this to preview an unknown API; when you're ready to actually read data, call liquid_connect, which discovers and maps and saves a reusable adapter.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Base URL of the API to inspect (same forms as liquid_connect's url). | |
| credentials | No | Optional secrets for an auth-walled API, e.g. {"api_key": "..."}, {"token": "..."}, or {"username": "...", "password": "..."}. Stored encrypted under ~/.liquid and applied automatically on every later fetch. Omit for public APIs. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| service | No | ||
| discovery_method | No | How it was found: openapi, graphql, soap, grpc, websocket, mcp, rest_heuristic, or browser. | |
| auth_type | No | ||
| endpoints | No | ||
| error | No |