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

# POST /v1/projects/{project_id}/audit-schedules

`POST /v1/projects/{project_id}/audit-schedules`

## Request

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

## Path parameters

- `project_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `prompt_set_id` string, uuid, required
  - `audit_scope` 'brand' | 'commerce'
  - `cadence` 'one_time' | 'every_n_minutes' | 'hourly' | 'daily' | 'weekly', required
  - `interval_minutes` integer, nullable
  - `timezone` string
  - `engines` LogicalEngine[], required
  - `market_ids` string[]
  - `repetitions` integer, nullable
  - `benchmark_mode` 'consumer_like' | 'controlled_localized' | 'forced_grounded'
  - `enabled` boolean
  - `next_run_at` string, date-time, nullable

## Response `201`

Successful Response

- AuditSchedule
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `project_id` string, uuid, required
  - `prompt_set_id` string, uuid, required
  - `audit_scope` 'brand' | 'commerce', required
  - `cadence` 'one_time' | 'every_n_minutes' | 'hourly' | 'daily' | 'weekly', required
  - `interval_minutes` integer, nullable, required
  - `timezone` string, required
  - `engines` LogicalEngine[], required
  - `market_ids` string[], required
  - `repetitions` integer, nullable, required
  - `benchmark_mode` 'consumer_like' | 'controlled_localized' | 'forced_grounded', required
  - `enabled` boolean, required
  - `next_run_at` string, nullable, required
  - `last_run_at` string, nullable, required
  - `failure_count` integer, required
  - `last_error` string, required
  - `last_failure_at` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, 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)