---
search:
  tags:
    - Site audits
    - POST
seo:
  description: >-
    Starts a paid one-page Site audit of the brand's input landing-page URL (the
    audit… Reference for the POST /site-audits endpoint in the Zaraftis Public
    API.
sidebar:
  label: Start a site audit
  badge: POST
title: Start a site audit
type: openapi-operation
---
Starts a paid one-page Site audit of the brand's input landing-page URL (the audit never expands beyond that page, but it reads domain-control resources such as robots.txt and sitemap files). Body: { brand_id: uuid }, an accessible, non-archived workspace brand inside the credential allowlist. Returns 202 Accepted with the audit, task, and billing references; the collected data and issued issues become readable at GET /v1/site-audits/{audit_id} when the audit reaches a usable terminal state. The accepted call authorizes the fixed 10-credit reservation; a failed audit releases it.

`POST /site-audits`

**Request body** (`application/json`, required)

- `brand_id` (string<uuid>, required)

Request body example:

```json
{
  "brand_id": "1bb61461-e5e3-4ebb-8cc6-5b0c37f1b7da"
}
```

**Responses**

- `202` — Accepted audit (audit, task, and billing references)
- `400` — bad\_request or validation\_failed
- `402` — wallet\_not\_activated, insufficient\_credits, or payment\_action\_required
- `404` — not\_found: unknown id, or an id this key cannot see
- `429` — rate\_limited: wait the Retry-After seconds
- `503` — capacity\_unavailable, spending\_temporarily\_unavailable, or reconciliation\_pending