---
title: "Post Quality Samples"
method: POST
path: "/api/call-quality/samples"
tags: ["call-quality", "call-quality"]
---

# Post Quality Samples

`POST /api/call-quality/samples`

Accept a batch of audio quality windows.

Queued, not written here (app.core.deferred). The client discards the
response body entirely, so there is nothing for it to wait on.

The rate limit is deliberately close to the real cadence: the client
flushes once a minute, so ten a minute leaves room for a teardown flush
and a retry and stops a loop from writing thousands of rows.

## Headers

- `authorization` string, nullable

## Request body

- SampleBatch
  - `room_name` string, required
  - `context` string, nullable
  - `client` string, nullable
  - `kind` string, nullable
  - `samples` QualitySample[], required
    - `observed_at` string, date-time, required
    - `window_ms` integer, nullable
    - `verdict` string, nullable
    - `out_verdict` string, nullable
    - `out_loss_pct` number, nullable
    - `out_jitter_ms` number, nullable
    - `out_rtt_ms` number, nullable
    - `out_kbps` number, nullable
    - `out_silent` boolean, nullable
    - `in_verdict` string, nullable
    - `in_loss_pct` number, nullable
    - `in_jitter_ms` number, nullable
    - `in_jbuf_ms` number, nullable
    - `in_concealed_pct` number, nullable
    - `in_streams` integer, nullable
    - `in_silent_streams` integer, nullable
    - `worst_identity` string, nullable
    - `detail` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 21 revisions in range; 1 not diffed.

- **2026-09-16** `f2ed591742c9` — 1 info
  - added the new optional request property `kind`
- **2026-09-13** `3c5400a294e1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/changes/api/call-quality/samples/post.md)

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/revisions/13996d792e23?raw)