Run QA cohort

Score every eligible call in a QA cohort now.

POSThttps://api.tried.com.au/qa/cohorts/{id}/run

Needs keys Scores the cohort's eligible calls now and waits until they are done. A call is eligible when it is ended, matches the cohort's filters and sample, has a transcript and has not been scored yet. Scoring stops at the cohort's weekly_max for the last 7 days. Up to the 5000 newest matching calls are checked.

AI judging needs an OpenAI key; without one the keyword scorer is used.

Request#

Field	Type	Required	Description
`id`	string	Yes	QA cohort ID, for example `qa_cohort_2c4e6a8b0d1f3e5a7c9b1d3f`.

The body is ignored.

Example request#

curl -X POST https://api.tried.com.au/qa/cohorts/qa_cohort_2c4e6a8b0d1f3e5a7c9b1d3f/run \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/qa/cohorts/qa_cohort_2c4e6a8b0d1f3e5a7c9b1d3f/run", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const run = await res.json();

import os, requests

res = requests.post(
    "https://api.tried.com.au/qa/cohorts/qa_cohort_2c4e6a8b0d1f3e5a7c9b1d3f/run",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
run = res.json()

Response#

200 OK

{
  "scored": 12
}

Field	Type	Description
`scored`	integer	Calls scored by this run. `0` when nothing new matched or the weekly cap is reached.

Each scored call adds its minutes to QA usage. See Get QA usage.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `analytics` scope. Dashboard users with the member role get `The member role is read-only`.
`404`	No cohort with that ID in the workspace: `QA cohort <id> not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell's public API reference has no AI QA endpoints, so this route has no Retell SDK equivalent.