DevelopersAPI ReferenceAPI v2

Grep API v2

Start runs and read their results. Pin the effort tier or agent, fetch the rendered report and any files it produced, and check your credit balance before each call.

OpenAPI JSONMarkdown Reference
POST/api/v2/runs

Start a Grep run.

GET/api/v2/runs

List runs.

GET/api/v2/runs/{job_id_or_slug}

Fetch run status, report, and structured output.

GET/api/v2/runs/{job_id_or_slug}/files

List the files a run generated.

GET/api/v2/runs/{job_id_or_slug}/timeline

Fetch the run timeline.

GET/api/v2/quota

Read API quota and credit balance.