> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm a Pitch Audit

> Confirm the saved prompt set of a Pitch Audit and queue asynchronous, billable answer collection. This is the billable step of the manual review flow.

Confirms the saved prompt set and queues asynchronous answer collection. This
is the billable transition in the manual-review flow.

**Authorization** `string` *required*

Bearer token. Example: `Bearer qw-api-xxx`

**Idempotency-Key** `string` *required*

Unique key for this confirmation. Replaying the same request returns the
original response instead of starting another answer wave.

**auditId** `string` *required*

Pitch Audit ID owned by the API key's agency team.

**prompts** `array`

Optional final replacement set of 20 to 100 prompts, with the fields of
[Save Pitch Audit prompts](https://docs.qwairy.co/developers/endpoints/pitch-audits/save-prompts.md).
Omit to confirm the saved prompts.

**modelIds** `array`

Optional final model selection. Omit to use the models stored on the audit.

## Synthetic request

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/pitch-audits/$AUDIT_ID/confirm" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: confirm-pitch-northstar-001" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

Returns `202` with a `Location` header pointing to the audit. The response
includes `requiredCredits`, `availableCredits`, and `dispatchStatus`. Poll
[Get Pitch Audit](https://docs.qwairy.co/developers/endpoints/pitch-audits/get.md), or list audits, to
follow progress through `RUNNING`, `RECOVERING`, `COMPLETED`, or `FAILED`.

Credits are charged by the existing Pitch Audit answer workflow as answers are
completed. A successful replay of the same idempotent confirmation does not
create a second response wave.

## Errors

| Status | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | No prompts or no supported model is available |
| `404` | `RESOURCE_NOT_FOUND` | Audit is absent or belongs to another team |
| `409` | `INVALID_STATE_TRANSITION` | Audit is not awaiting confirmation |
| `409` | `INSUFFICIENT_CREDITS` | The current balance cannot cover the answer wave |
| `409` | `IDEMPOTENCY_CONFLICT` | Key reused with a different request |

Concurrent confirmations of the same audit start answer collection once. The
other requests receive `409 INVALID_STATE_TRANSITION`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.