---
title: "Request Agent Readiness Audits"
method: POST
path: "/agent-analytics/readiness/audits"
tags: ["Agent Analytics"]
---

# Request Agent Readiness Audits

`POST /agent-analytics/readiness/audits`

## Request

- Base URL: `https://api.peec.ai/customer/v1`
- URL: `https://api.peec.ai/customer/v1/agent-analytics/readiness/audits`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
  - HTTP bearer

Queue Peec's agent readiness audit for the project's own brand domains. Audits run only on domains of the project's own brands, matched exactly as the brand lists them; any other domain is returned in `rejected` and the rest of the request still goes through. A domain whose audit is already queued or running is returned in `skipped` with that run's id instead of queuing a second one.

Audits run in the background. Follow each one with `GET /agent-analytics/readiness`, where the domain's `latest_run` carries the same id and its status, and read the result there once it is `completed`.

## Request body

- object
  - `project_id` string: Required if using a company api key
  - `domains` string[], required: Up to 50 of the project's own brand domains, exactly as `GET /agent-analytics/readiness` lists them in `own`.

## Response `200`

Per-domain results

- object: Per-domain results
  - `created` object[], required: Domains a new audit was queued for.
    - `domain` string, required: One of the project's own brand domains.
    - `run_id` string, required: The id of the audit run serving this request.
  - `skipped` object[], required: Domains with an audit already queued or running. No new audit is queued; `run_id` is the one in progress.
    - `domain` string, required: One of the project's own brand domains.
    - `run_id` string, required: The id of the audit run serving this request.
    - `reason` 'in_progress', required
  - `rejected` object[], required: Domains not audited: `not_own_domain` for a domain that isn't one of the project's own brand domains, `duplicate` for a repeat within the request.
    - `domain` string, required
    - `reason` 'not_own_domain' | 'duplicate', required
    - `message` string, required

## Other responses

- `403`: Response for status 403

## Changes

- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/agent-analytics/readiness/audits/post.md)

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) - [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peec/apis/peec-ai-customer-api/revisions/9d774600c8eb?raw)