## Audit

### POST /api/v1/audits
Create Audit query
Use the `id` from a successful response to poll for state updates, as the process is asynchronous and might take a while to complete.

**Rate limit**: 10 requests/sec

**Parameters**

- `Workspace-Id` (header, integer) — Workspace ID to create the audit in. If not provided, uses the oldest active workspace.

**Request body**

```json
{
  "cache": 3600,
  "device": "mobile",
  "location": "United States",
  "keyword": "How to write content that ranks?",
  "url": "https://surferseo.com/"
}
```

**Responses**

- **201** — 
```json
{
  "id": 123,
  "state": "scheduled",
  "permalink_hash": "G74SCitlYgE_N8iIYIxIS_US8yuUgsfx"
}
```
- **422** — Quota exceeded | No access
- **429** — Rate limit exceeded


### GET /api/v1/audits/{id}
Get Audit query
Use this endpoint to poll for state updates.

**Rate limit**: 10 requests/sec

**Parameters**

- `id` (path, integer, required)

**Responses**

- **200** — 
- **404** — Not found
- **429** — Rate limit exceeded