> ## 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 grep

> Search the Base44 API spec with a regular expression

Search each [Apps API](/developers/references/apps-api/get-started/overview) and [Workspace API](/developers/references/workspace-api/get-started/overview) operation's path, summary, description, parameters, request body, and response with a regular expression. Use it when [`api search`](/developers/references/cli/commands/api-search) misses, for example to find every operation that sends or returns a field such as `webhook_secret`.

## Usage

```bash theme={null}
base44 api grep <pattern>
```

## Arguments

| Argument | Description | Required |
| - | - | - |
| `<pattern>` | A JavaScript regular expression, for example `"runs.*status"`. | Yes |

## Flags

| Flag | Description |
| - | - |
| `--area <area>` | Search only one area's operations. Run [`api catalog`](/developers/references/cli/commands/api-catalog) to list the areas. |
| `-i, --ignore-case` | Match regardless of case. |
| `--limit <n>` | Maximum number of operations to return. Defaults to `20`. |
| `--read-only` | Search 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, 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": "GET /api/workspace/{workspace_id}/connectors", "summary": "List workspace connectors" },
  { "endpoint": "GET /api/apps/{app_id}/oauth-redirect-uris", "summary": "Get OAuth redirect URIs" }
]
```

## See also

* [`api search`](/developers/references/cli/commands/api-search): Search API operations by keyword
* [`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.