Skip to main content
Polls the status of an asynchronous run. Use it after gtm_audit or org_audit. While the run is in progress it returns a short status line; once the run is completed it returns the full markdown result.
​
string
required
The run type. One of:
  • "gtm-audit" — for a run started by gtm_audit
  • "audit" — for a run started by org_audit
​
string
required
The run id returned by the tool that started the run.
Type: synchronous · Returns: a status line, or the full result markdown when complete

​
Example call

​
Returns

In progress — a status line:
Completed — the full audit markdown (for a GTM audit, the audit slides; for an org audit, the rendered report). Not found — returns not found if the id doesn’t exist or belongs to another organization.
The kind must match how the run was started. Polling a gtm-audit id with kind: "audit" (or vice versa) returns not found.

​
Polling guidance

Audits take from tens of seconds to several minutes. Poll on an interval (e.g. every 10–20s) rather than in a tight loop, and stop once status is completed or failed. See Async runs.