EVIDE Minimum Intake JSON
EVIDE (External Evidentiary Deposit) is a structured evidentiary intake layer designed to anchor AI-assisted or human decisions to an independent, cryptographically verifiable record. Each intake transforms a closed decision into a portable evidentiary object that can be validated outside the originating system, without requiring operational access to the source system, its logs, or its infrastructure.
It standardises the minimum evidentiary object that can survive outside the source system."
EVIDE does not:
- verify whether the declared authority was legitimate
- validate the correctness of the decision
- introduce admissibility logic
- replace governance frameworks
- operate inside the decision pipeline
EVIDE operates at a specific and bounded layer. Understanding what it does and does not do prevents misuse and misinterpretation.
- EVIDE records closure state, not runtime execution
- EVIDE anchors the externally visible responsibility state at the moment a decision becomes final
- EVIDE preserves admissibility visibility without enforcing admissibility
- EVIDE is evidentiary, not supervisory
- EVIDE does not replay decisions — it anchors closure objects
- EVIDE does not verify declared oversight — it makes the declaration persistent, portable, and independently verifiable
Behavioral completion vs. Responsibility closure
A finalized decision without a bound authority represents behavioral completion only — the system produced an outcome, but no accountable actor is formally attached to it.
A finalized decision with a bound authority and declared human oversight represents responsibility closure — the outcome is not only produced, but explicitly attributable.
The Layer 2 → Layer 3 boundary requires responsibility closure, not behavioral completion.
EVIDE access provisioning requires DAPI identity verification. This requirement exists because EVIDE operates as an evidentiary responsibility layer. The intake infrastructure must be able to attribute API activity to a verifiable identity source, even when deposited payloads contain declared or non-verified authority states.
DAPI therefore functions as the identity-bound access layer of the EVIDE intake infrastructure, separating:
- infrastructure access attribution
- payload-declared authority
- evidentiary responsibility visibility
The EVIDE intake payload is a JSON object submitted via POST. It is canonicalized and hashed deterministically before storage. The current schema version is "2.1", the only value accepted by the API today. Earlier values ("1.8", "1.9", "2.0") are historical — see Section 5 for their evolution — and are no longer accepted.
evide_schema— must be"2.1". Earlier values ("1.8","1.9","2.0") are historical and no longer accepted.source_system— name of the originating systemsource_reference— unique decision identifier in the source systemsource_timestamp_utc— ISO 8601 UTC timestamp of decision productiondecision.type— decision category (e.g.candidate_evaluation,risk_classification)decision.status— must be"finalized"decision.closure_timestamp_utc— UTC timestamp of closuredecision.summary— natural-language description of the decisionauthority.id— authority identifier in the source systemauthority.role— role of the authority
authority.verification— DAPI reference code linking the authority to a verified identity. Without it,evidentiary_profile.identityreturns"declared"instead of"claimed"intervention.type— override / approval / rejection / escalationintervention.classification_context— upstream governance structure visibility (introduced v1.7). Required.human_oversight.is_declared+declared_level— L1 / L2 / L3fedis_requested— triggers FEDIS forensic certification workflowchain— links this intake to a previous one, forming a verifiable evidentiary chain (introduced v1.0 as a base-schema field, extended v2.1 withmatter_reference).chain.parent_evide_id— EVIDE ID of the previous record.chain.chain_type— free text describing the continuation (e.g.litigation_hold,internal_investigation).chain.matter_reference— optional, inherited from the parent if omitted; if declared on both sides it must match. Validation is strict: the parent must exist, belong to the same evidentiary domain, be in an accepted status, and — if a matter_reference is declared — match it. There is no silent fallback: an invalidparent_evide_idfails the request rather than silently starting a new chain. See Evidentiary Continuity for the full model.handoff— boundary state declaration for L3 intake. Required.boundary_readinessis a structured object with four canonical states (introduced v2.0). See Section 3.extensions— array of strings declaring which optional schema extensions this payload carries. Registered extensions:evidence_references,declarations. An extension must be declared here to be accepted (v2.1).evidence_references— array of declared external artifact references (screenshots, video, sensor logs, documents), anchored without EVIDE storing the underlying file. Optional integrity hash per artifact, declared by the submitter. Requires"extensions": ["evidence_references"]on the same payload. (v2.1)declarations— array of explicit, attributable, time-bound statements of the operational perimeter (environment, privileges, purpose, tools, prohibited operations, agent configuration) an agent was authorized within, before it acted. EVIDE preserves the declaration only — it never verifies its correctness, applies it as policy, or compares it against observed behavior. Requires"extensions": ["declarations"]on the same payload. See EVIDE ANCHOR. (v2.1)
extensions is rejected, and an extension listed in extensions with no corresponding content is rejected as well. Nothing enters the evidentiary object without having been announced, and nothing is announced without being present. This follows the same validation discipline used throughout EVIDE: declarations and payload content must remain mutually consistent. Documented defaults exist — an omitted chain.matter_reference inherits the parent’s — but an inconsistency between what is declared and what is present is never repaired by inference. No silent fallback is performed.The chain guarantees above are enforced at intake, not reconciled afterwards. Each condition returns its own code, so an integrator can tell a data error from an authorization refusal without parsing prose:
| Status | Error | Condition |
|---|---|---|
| 422 | invalid_field | chain.parent_evide_id is not a well-formed EVIDE ID. Checked before any database lookup. |
| 422 | chain_parent_not_found | The ID is well-formed but matches no existing record. |
| 403 | chain_parent_not_owned | The parent exists but lies outside the evidentiary domain authorized by this API key. The only refusal in this family that is an authorization decision rather than a payload error. |
| 422 | chain_parent_invalid_status | The parent is not in an accepted status. Reachable only when chaining to a record you own — for any other parent the ownership refusal above takes precedence. |
| 422 | chain_matter_mismatch | Both sides declare a matter_reference and the two differ. |
chain_parent_not_found for records that do not exist and chain_parent_not_owned for records outside your domain — neither response confirms who owns a record, what status it is in, or whether it exists at all beyond that distinction.hashed_by) and is never presented as an integrity verification performed by EVIDE. This differs from the content_hash and intake hash described in Section 4, which EVIDE computes directly over the submitted payload itself.Full schema reference: app.certifywebcontent.com/json
The classification_context object exposes whether the classification act was supported by an upstream taxonomy and threshold structure at the moment of recording. It does not validate the threshold — it makes the presence or absence of such a structure externally visible. Required.
met— threshold was defined and the decision satisfied itnot_met— threshold was defined but not satisfiedunknown— threshold may exist but state is not verifiable at deposit timenot_defined— no threshold was formally defined for this classification
threshold_status: "not_defined" does not indicate an operational error. It signals that at the moment of decision, no formally defined governance structure existed — a governance gap made externally visible, not a system failure.Exposes whether the threshold had a structurally attributable source of authority at closure. attribution_status is required when threshold_authority is present.
attributed— single identifiable authority defined at closurefragmented— threshold defined across multiple sources, no single attributable authorityimplicit— threshold present in practice but not formally defined or attributableunknown— threshold authority not verifiable at the moment of closure
The handoff object defines the boundary state of a closure object before EVIDE accepts it for external anchoring. Required. boundary_readiness is a structured object with four canonical states (promoted from a plain string in v2.0).
status— required. One of:candidate,verified,verified_partial,unverifiable.readiness_gate.identifier— required when status ≠candidate. Name or ID of the gate system that performed the assessment.readiness_gate.scope_reference— required when status ≠candidate. URL or hash of the gate policy document. Makesverifiednon-self-referential.visibility_surface— categorical declaration of the gate's observational coverage:null(candidate),partial,declared_complete,insufficient.unresolved_signals— string array of signal identifiers the gate could not resolve. Empty forcandidateandverified. Minimum one element forverified_partialandunverifiable.
candidate— readiness_gate: null, visibility_surface: null, unresolved_signals: []. No gate has operated. Upstream declaration only.verified— readiness_gate: present, visibility_surface: declared_complete, unresolved_signals: []. Gate confirmed stability across complete visibility.verified_partial— readiness_gate: present, visibility_surface: partial, unresolved_signals: [min. 1]. Gate confirmed what it could see. Gaps declared explicitly.unverifiable— readiness_gate: present, visibility_surface: insufficient, unresolved_signals: [min. 1]. Gate operated but surface was below minimum threshold. Proves diligence, not failure.
reconstruction_independence— must bedeclaredfor EVIDE intake.submission_status— must benot_submittedwhen sent by the upstream system.acceptance_status— must benot_claimedwhen sent by the upstream system.
After a successful intake, EVIDE returns the updated handoff state with submission_status: "submitted" and acceptance_status: "accepted". In v2.0, boundary_readiness is returned as a structured object. The response also includes evidentiary_profile — a server-computed eleven-dimensional read of the intake object (profile_version: "1.1"). The profile is not part of the submitted payload and is not included in the canonical hash. The original submitted payload is stored and hashed without modification.
boundary_readiness and runtime conditions - architectural note (v2.0)
EVIDE anchors closure states, not runtime states. It does not monitor conditions after anchoring and does not introduce runtime governance.
"They come from anchoring something that was already drifting at the moment it was externalized."
In v2.0, this failure mode is addressed more precisely. The gate's own observational capacity becomes part of the evidentiary record. What the gate could not see is declared explicitly in unresolved_signals — it is no longer a hidden assumption but a documented variable.
A system cannot self-certify boundary_readiness.status = "verified". That evaluation must come from an independent gate declared in readiness_gate.identifier. If the gate's visibility was incomplete, the honest state is verified_partial with declared gaps — not verified.
unverifiable is not a failure state. It is the most forensically honest state when an independent gate operated but the source system was too opaque to confirm boundary stability.
Gate independence is a governance qualification, not a self-declared payload field in v2.0. Formal gate qualification is deferred to the v2.x Gate Qualification Framework.
Before computing the SHA-256 hash, the system canonicalizes the JSON: keys are sorted alphabetically at all levels and the result is minified. This guarantees that two semantically identical payloads always produce the same hash regardless of key submission order. The content_hash field is excluded before hashing.
- Remove the
content_hashnode if present - Recursively sort all keys alphabetically at every nesting level
- Serialize to minified JSON (UTF-8, no escaped slashes)
- Compute SHA-256 of the resulting string
taxonomy_reference → threshold_authority → threshold_reference → threshold_status.Key ordering inside handoff.boundary_readiness (v2.0):
readiness_gate → status → unresolved_signals → visibility_surface.These orderings are enforced by recursive ksort and must be respected when computing
content_hash on the source side.
content_hash is an optional client-side reference — it extends the integrity chain to cover the pre-intake transit as well.EVIDE follows a strict backward-compatible evolution model. Each version adds optional fields or response attributes without breaking existing integrations.
| Version | Addition |
|---|---|
| 1.0 | Base schema — decision, authority, intervention, human_oversight, chain |
| 1.1 | created_at_utc, object_class, content_hash |
| 1.2 | intervention.rationale_type |
| 1.3 | intervention.taxonomy_version — enables classification replay in audit |
| 1.4 | fedis_requested — triggers FEDIS forensic certification workflow |
| 1.5 | authority_verification_status (response) — claimed vs declared |
| 1.6 | intervention.classification_status — stable / provisional / contested |
| 1.7 | intervention.classification_context — upstream governance structure visibility |
| 1.8 | classification_context.threshold_authority — threshold ownership attributability |
| 1.9 | handoff — boundary-ready schema, universal handoff contract for L3 intake. boundary_readiness as string: candidate | verified. |
| 2.0 | handoff.boundary_readiness promoted from string to structured object. Four canonical states: candidate, verified, verified_partial, unverifiable. Adds readiness_gate (identifier + scope_reference), visibility_surface, unresolved_signals. intervention.classification_context required. decision.status must be "finalized". Response includes evidentiary_profile (server-computed, profile_version 1.1) with eleven evidentiary dimensions. Dimension 9 (continuity) inferred via Forensic Cross-Check (classification x runtime_visibility) — anti-Synthetic-Coherence sensor. Dimension 10 (decision_wave_compression / DWC) inferred: runtime_visibility x boundary_readiness x unresolved_signals. Dimension 11 (formal_accountability_collapse / FAC) inferred: authority x threshold_attribution x continuity_state. States for dim 10-11: not_detected | detected | critical | unknown. Superseded by 2.1 — no longer a currently accepted evide_schema value. |
| 2.1 | Adds extensions array declaring active schema extensions, and evidence_references array for declaring external artifacts (screenshots, video, sensor logs, documents) anchored without EVIDE storing the underlying file. Each reference carries artifact_type (free text), pointer, declared_origin, declared_description, and an optional hash object, declared by the submitter and never independently verified by EVIDE. The additions are non-breaking at the payload structure level — both fields are omitted entirely on payloads that do not use them. Adds chain.matter_reference and strict server-side validation of chain continuations (parent must exist, same evidentiary domain, accepted status, matching matter — never a silent fallback). Later within 2.1, adds declarations array (EVIDE ANCHOR) for explicit, attributable, time-bound statements of the operational perimeter an agent was authorized within, before it acted — each entry returns a server-computed declaration_digest, never sent by the client. "2.1" is the current and only evide_schema value accepted by the API. |
Full architectural backlog: app.certifywebcontent.com/docs/evide-v2-roadmap/
EVIDE is designed to receive structured closure objects from any system — AI pipelines, workflow engines, governance platforms, runtime agent systems — without requiring integration inside the decision pipeline.
The minimal boundary requirements for the source system are:
- an explicit closure state (not only behavioral completion)
- an identified authority bound to that closure
- an explicit responsibility declaration
- a stable reference to the upstream trace
- a coherent classification context (even if initially internal)
evidence_id→source_reference(primary object identity)event_id→intervention.trace.reference(runtime event identity)trace_reference→intervention.trace.reference(upstream trace continuity)
Reference implementation: RANKIGI × EVIDE Interface Mapping (v0.4.1)
FEDIS (Forensic Evidence Declaration & Integrity Statement) transforms an EVIDE intake record into a legally presentable forensic artifact. It is not a default system artifact but a formal evidentiary output generated through a certification process, triggered by setting fedis_requested: true in the intake payload.
Reference: certifywebcontent.com — FEDIS
A FEDIS-ready EVIDE record must include:
- cryptographically fixed closure state (SHA-256 intake hash)
- independent UTC intake timestamp
- declared authority bound to the closure
- classification context sufficient for external interpretation
- stable upstream trace reference
FEDIS extends the EVIDE record with a qualified eIDAS digital signature, RFC 3161 timestamping, SHA-256 and SHA-512 fingerprints, formal chain of custody declaration, and sworn statement — making the same record usable in audit, regulatory, and judicial contexts without reprocessing.
- Source system — produces the decision and surfaces the closure object
- EVIDE — anchors the closure object externally with integrity and timestamp
- FEDIS — transforms the anchored record into a legally presentable artifact
Three layers.
One independent record.