---
title: "POST /v1/projects/{project_id}/audits"
method: POST
path: "/v1/projects/{project_id}/audits"
tags: ["audits"]
---

# POST /v1/projects/{project_id}/audits

`POST /v1/projects/{project_id}/audits`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/audits`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `prompt_set_id` string, uuid, nullable
  - `prompt_ids` string[]
  - `engines` LogicalEngine[], required
  - `repetitions` integer, nullable
  - `benchmark_mode` 'consumer_like' | 'controlled_localized' | 'forced_grounded'
  - `market_ids` string[]
  - `audit_scope` 'brand' | 'commerce'
  - `random_seed` string, nullable
  - `max_attempts` integer, required

## Response `201`

Successful Response

- Audit[]
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `project_id` string, uuid, required
  - `parent_audit_id` string, uuid, nullable, required
  - `status` 'draft' | 'validating' | 'queued' | 'running' | 'analyzing' | 'reporting' | 'completed' | 'partially_completed' | 'failed' | 'cancelled', required
  - `benchmark_mode` string, required
  - `audit_scope` 'brand' | 'commerce', required
  - `model_provenance` ModelProvenance[], required
    - `logical_engine` string, required
    - `transport_provider` string, required
    - `transport_model` string, required
    - `retrieval_enabled` boolean, nullable, required
  - `repetitions` integer, required
  - `random_seed` string, required
  - `requested_count` integer, required
  - `completed_count` integer, required
  - `failed_count` integer, required
  - `error_message` string, required
  - `engine_snapshots` object[], required
    - `logical_engine` string, required
    - `transport_provider` string, required
    - `transport_model` string, required
  - `market` object, required
    - `id` string, uuid, nullable, required
    - `country_code` string, required
    - `language_code` string, required
  - `launch_id` string, uuid, nullable, required
  - `not_applicable_engines` LogicalEngine[], required
  - `created_at` string, required
  - `updated_at` string, required
  - `started_at` string, nullable, required
  - `completed_at` string, nullable, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)