Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

nia_sk_...

Headers

Idempotency-Key
string
required

Required. Kept 24 hours with the hash of the body: a retry with the same key returns the first answer, and the same key with a different body returns 409 conflict.

Required string length: 1 - 256

Body

application/json

What the company's CI reports after running the scenarios N times: the statistics stay with Niadra. Every pin the recording requires must match each scenario's recorded build, except those in vary.

build
TurnBuild · object
required
results
ReplayResult · object[]
required
Required array length: 1 - 5000 elements
scenario_ids
string[]
required
Required array length: 1 - 200 elements
Required string length: 1 - 512
mode
enum<string>
default:hermetic_turn
Available options:
hermetic_turn,
hermetic_conversation,
era_memory
runs
integer | null
Required range: 1 <= x <= 100
vary
enum<string>[]
Maximum array length: 5
Available options:
prompts,
corpus_digest,
model,
assembler,
tool_schemas

Response

The run, with its verdict decided.

build
TurnBuild · object
required
created_at
string<date-time>
required
mode
enum<string>
required
Available options:
hermetic_turn,
hermetic_conversation,
era_memory
run_id
string
required
Required string length: 1 - 512
status
enum<string>
required
Available options:
pending,
done
summary
ScenarioRunSummary · object
required
vary
enum<string>[]
Available options:
prompts,
corpus_digest,
model,
assembler,
tool_schemas
verdict
enum<string> | null

The worst of the scenarios' verdicts.

Available options:
pass,
flaky,
infrastructure_error,
pin_mismatch,
regression