Confirm a Pitch Audit
curl --request POST \
--url https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"prompts": [
{}
],
"modelIds": [
{}
]
}
'import requests
url = "https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm"
payload = {
"prompts": [{}],
"modelIds": [{}]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({prompts: [{}], modelIds: [{}]})
};
fetch('https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Pitch audits
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.
POST
https://www.qwairy.co
/
api
/
v1
/
pitch-audits
/
{auditId}
/
confirm
Confirm a Pitch Audit
curl --request POST \
--url https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"prompts": [
{}
],
"modelIds": [
{}
]
}
'import requests
url = "https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm"
payload = {
"prompts": [{}],
"modelIds": [{}]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({prompts: [{}], modelIds: [{}]})
};
fetch('https://www.qwairy.co/api/v1/pitch-audits/{auditId}/confirm', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Confirms the saved prompt set and queues asynchronous answer collection. This
is the billable transition in the manual-review flow.
Concurrent confirmations of the same audit start answer collection once. The
other requests receive
Unique key for this confirmation. Replaying the same request returns the
original response instead of starting another answer wave.
Optional final replacement set of 20 to 100 prompts, with the fields of
Save Pitch Audit prompts.
Omit to confirm the saved prompts.
Synthetic request
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
Returns202 with a Location header pointing to the audit. The response
includes requiredCredits, availableCredits, and dispatchStatus. Poll
Get Pitch Audit, 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 |
409 INVALID_STATE_TRANSITION.
