Get QA cohort

Read one QA cohort by ID.

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

Returns a QA cohort's filters, criteria, metrics and pass threshold.

Request#

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

Example request#

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

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

import os, requests

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

Response#

200 OK

{
  "qa_cohort_id": "qa_cohort_2c4e6a8b0d1f3e5a7c9b1d3f",
  "name": "Booking calls",
  "agent_ids": [
    "agent_4b7e2c9a1f3d5e8b0c6a2d1f"
  ],
  "from_timestamp": null,
  "to_timestamp": null,
  "min_duration_ms": 30000,
  "max_duration_ms": null,
  "disconnection_reasons": [],
  "sampling_percent": 50,
  "weekly_max": 200,
  "criteria": [
    {
      "name": "Confirms the booking",
      "prompt": "The agent reads back the date and time and says \"you are booked in\".",
      "weight": 2
    },
    {
      "name": "Offers a reminder",
      "prompt": "The agent offers an SMS reminder before the appointment."
    }
  ],
  "created_timestamp": 1792395000000,
  "last_run_timestamp": 1792395060000,
  "extraction_filters": [
    {
      "source": "analysis",
      "key": "appointment_booked",
      "op": "eq",
      "value": true
    }
  ],
  "metrics": [
    {
      "metric": "latency",
      "weight": 1
    },
    {
      "metric": "sentiment",
      "weight": 1,
      "threshold": 60
    }
  ],
  "pass_threshold": 70,
  "calibration": null
}

Field	Type	Description
`qa_cohort_id`	string	Cohort ID, prefixed `qa_cohort_`.
`last_run_timestamp`	integer or null	Unix ms of the last run.
`calibration`	object or null	Result of the last applied calibration.

The other fields echo the cohort settings. See Create QA cohort.

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.
`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.