Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

nia_sk_...

Body

application/json

A case for one turn, alone or as part of a scenario. build is the build the runner will run; every pin the recording requires must match the recorded one, except the pins in vary, which the run changes on purpose.

build
TurnBuild · object
required
turn_id
string
required
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
mode
enum<string>
default:hermetic_turn
Available options:
hermetic_turn,
hermetic_conversation,
era_memory
scenario_id
string | null
Required string length: 1 - 512
vary
enum<string>[]
Maximum array length: 5
Available options:
prompts,
corpus_digest,
model,
assembler,
tool_schemas

Response

Successful Response

What the replay runner needs to run a turn again inside the company's boundary: the record, with the kept values in stored mode and the pointers and digests otherwise; the pins; the conversation's masked history up to the turn, ending with the turn's own input; and the assertions. The pack of the time is the blob of the record's pack read.

case_id
string
required
Required string length: 1 - 512
expires_at
string<date-time>
required

When the turn leaves storage; after it, replay_expired.

input
ReplayInput · object
required
mode
enum<string>
required
Available options:
hermetic_turn,
hermetic_conversation,
era_memory
record
TurnRecord · object
required

One turn, from its input (a message, an interface action, an event, a timer firing) to the last thing it emitted to the customer or to a document.

required_pins
enum<string>[]
required
Available options:
prompts,
corpus_digest,
model,
assembler,
tool_schemas
turn_id
string
required
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
assertions
ReplayAssertion · object[]
history
ReplayHistoryEntry · object[]
scenario_id
string | null
Required string length: 1 - 512
vary
enum<string>[]
Available options:
prompts,
corpus_digest,
model,
assembler,
tool_schemas