Skip to main content
POST
Add cases from calls

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Headers

Idempotency-Key
string

Optional key, unique per organization (1-255 printable ASCII characters, e.g. a UUID). Resending a request with the same key returns the original result instead of creating a second one; reusing it for a different request is a 409 idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

id
string<uuid>
required

Benchmark id.

Body

application/json
conversationIds
string<uuid>[]
required
Required array length: 1 - 200 elements
strategy
enum<string>
required

Which steps of each call become cases: last_reply, every_reply, every_tool_call, conversation (LLM) or whole_recording, caller_turns (STT).

Available options:
last_reply,
every_reply,
every_tool_call,
conversation,
whole_recording,
caller_turns
expected
enum<string>
default:as_recorded

as_recorded: the recorded step is the reference. review: save as draft cases to finish one by one.

Available options:
as_recorded,
review
checkGroupId
string<uuid> | null
tags
string[]

User tags (max 20); normalized to lowercase-kebab.

Maximum array length: 20
Maximum string length: 200
skippedJudgeIds
string<uuid>[]
Maximum array length: 100
dryRun

Plan the cases and return them without saving anything (the read is still audit-logged).

locale
enum<string>

Language of the generated case titles and drafted caller personas: en-us (default), es or pt.

Available options:
en-us,
es,
pt

Response

Successful response.

Cases created by one request (or, with dryRun, the cases that would be).

cases
object[]
required
skipped
object[]
dryRun
boolean
warning
string