This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the developer documentation.

base44 api grep

Search the public Base44 API spec with a regular expression, for when api search misses. For example, find every operation that sends or returns a field such as noindex.

Syntax

npx base44 api grep <pattern> [options]

Options

Option	Description	Default
`<pattern>`	A JavaScript regular expression, e.g. `"runs.*status"`; an invalid one fails	Required
`--area <area>`	Search only one area’s operations (see api-catalog.md)	-
`-i, --ignore-case`	Case-insensitive match	-
`--limit <n>`	Most operations to return	`20`
`--read-only`	Only operations the spec marks read-only	-
`--refresh`	Fetch the API spec again instead of using the cached copy (kept 1 hour)	-

Authentication

Required: No. The command only reads the API spec and sends nothing.

What It Matches

The pattern runs over each operation’s contract (the same JSON that api fetch <METHOD> <path> --help prints: endpoint, summary, description, parameters, request and response schemas) as JSON text. So:

Quotes and newlines appear escaped.
A common word also matches inside unrelated schemas; narrow it with --area.

Output

A JSON array of matching operations, or an empty array when nothing matches. Each one has an endpoint (method and path template) and a one-line summary:

[
  { "endpoint": "GET /api/apps/{app_id}/oauth-redirect-uris", "summary": "Get OAuth redirect URIs" }
]

Examples

npx base44 api grep "noindex" --area seo
npx base44 api grep "runs.*status" -i
npx base44 api grep "webhook_secret" --limit 5

api-search.md: search operations by what they do
api-fetch.md: read an operation’s contract and call it