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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# api search

> Search Base44 API operations by keyword

Search the [Apps API](/developers/references/apps-api/get-started/overview) and [Workspace API](/developers/references/workspace-api/get-started/overview) operations by keyword and get back the ones that match best. Use the words you'd expect in the operation's name, such as `failed workflow runs`. Common words such as "the", "my", and "how" are ignored. Each result gives you the endpoint to pass to [`api fetch`](/developers/references/cli/commands/api-fetch). Operations whose summary contains every word you searched for come first.

## Usage

```bash theme={null}
base44 api search <text...>
```

## Arguments

| Argument | Description | Required |
| - | - | - |
| `<text...>` | The words to search for, for example `failed workflow runs`. | Yes |

## Flags

| Flag | Description |
| - | - |
| `--limit <n>` | Maximum number of results to return. Defaults to `5`. |
| `--read-only` | Return only operations that can't change anything, the ones [`api fetch --read-only`](/developers/references/cli/commands/api-fetch) lets through. |
| `--refresh` | Get the latest list of operations from the server instead of the copy the CLI saved, which it keeps for up to an hour. Use it when an operation that was added recently is missing. |

## Output

The command returns a JSON array of matching operations, best match first, or an empty array when nothing matches. Each one has an `endpoint`, its method and path template, and a one-line `summary`:

```json theme={null}
[
  { "endpoint": "POST /api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}/analyze", "summary": "Analyze a failed workflow run" },
  { "endpoint": "GET /api/apps/{app_id}/workflows/runs", "summary": "List workflow runs for an app" }
]
```

## See also

* [`api grep`](/developers/references/cli/commands/api-grep): Search with a regular expression when `search` misses
* [`api catalog`](/developers/references/cli/commands/api-catalog): Browse operations by area
* [`api fetch`](/developers/references/cli/commands/api-fetch): Call an operation you found


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