Skip to main content
POST
Replay a retained trace artifact or restore a native-session projection

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

runId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json
requestId
string<uuid>
required

Tenant-scoped idempotency key; preserve it when retrying. Use a new key to reconsider a previously skipped or unrecoverable run.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
source
enum<string>
default:primary

Primary replays the persisted source declaration (native for historical runs); native_session selects retained native bytes for other providers or historical native-only Codex runs. Canonical Codex runs reject native replay.

Available options:
primary,
native_session

Response

Durable replay result

requestId
string<uuid>
required
runId
string<uuid>
required
status
enum<string>
required
Available options:
projected,
already_projected,
skipped,
unrecoverable
reason
enum<string>
Available options:
run_active,
ambiguous_artifacts,
missing_artifact,
unsupported_artifact,
artifact_not_retained
sourceKind
enum<string>
Available options:
execution_stream,
native_session
sha256
string
parserVersion
string
reconciliation
object