Skip to main content
GET
Verify the job's trace journal

Authorizations

Authorization
string
header
required

Exactly one Authorization: Bearer value from the token file

Path Parameters

id
string<uuid>
required

Response

Typed trace verdict

Run-scoped verdict on the journal the resident wrote for the job, through the ONE verifier nika trace verify --json runs. verdict is the CLI's headline word: the attained tier (ok · sealed · anchored · replayed), incomplete for a journal with no terminal frame (the writer's liveness rides reason), tampered for a buried seal, broken for an edited chain, and the CLI's refusal classes; unavailable only when no journal exists for the job (refused before its first event · queued · a backend keeping none). reason is the machine class beside it (the seal tier under a ladder verdict). The CLI's own document rides verbatim (exit · chain · seal · anchor · replay · lines); a filesystem path is never returned.

reason
enum<string>
required
Available options:
run_not_terminal,
trace_journal_unavailable,
sealed,
unsealed,
forged,
buried,
unattributable,
writer_alive,
writer_dead,
writer_unknown,
buried_seal,
broken,
unchained,
empty,
unreadable,
refused,
line_over_long,
unknown
verdict
enum<string>
required
Available options:
unavailable,
ok,
sealed,
anchored,
replayed,
incomplete,
tampered,
broken,
unchained,
empty,
unreadable,
refused,
line-over-long,
unknown
anchor
object
chain
object

events · head · headline (intact · torn · incomplete) · liveness (alive · dead · unknown · null)

exit
enum<integer>

The CLI's exit class: 0 the reported tier holds · 2 a forged or edited journal · 3 the environment (unchained · unreadable · a missing input) · 5 incomplete lifecycle evidence

Available options:
0,
2,
3,
5
lines
string[]

The CLI's ladder lines, the journal path replaced by

replay
object
seal
object

tier (unsealed · sealed · forged · buried · unattributable) and the tier's facts

trace_id
string
Minimum string length: 1
verify_version
integer
Required range: x >= 1