Evidence

Fetch a signed CyclesEvidence envelope by content id

Retrieve the signed CyclesEvidence envelope identified by evidence_id (the sha256 content hash carried on a receipt's cycles_evidence reference). Returns the envelope exactly as emitted — JCS-canonicalizable and Ed25519-signed per cycles-evidence-v0.2 — so any holder can verify it offline without trusting this server. AUTH (NORMATIVE): this endpoint is PUBLIC (no ApiKeyAuth). The evidence_id is an unguessable sha256 content hash that acts as a capability — only a party already holding the receipt (which carries the id) can fetch the envelope. Because the envelope is content-addressed and signature-verifiable, public read cannot forge or alter it. Servers SHOULD rate-limit this endpoint and SHOULD serve it with Cache-Control: public, immutable (the content never changes).

get/v1/evidence/{evidence_id}

Request

  • Base URL: https://api.cycles.local
  • URL: https://api.cycles.local/v1/evidence/{evidence_id}
  • Auth: none required

Path parameters

evidence_idstring required

sha256 content hash of the CyclesEvidence envelope (64 lowercase hex chars).

Response

The signed CyclesEvidence envelope.

schema_version'cycles-evidence/v0.1' required
artifact_type'decide' | 'reserve' | 'commit' | 'release' | 'error' required
server_idstring required

Stable URI of the issuing Cycles server.

signer_didstring required

Ed25519 public key (v0.1 hex) the signature verifies against.

issued_at_msinteger required
trace_idstring
payloadobject required

One key matching artifact_type (decide/reserve/commit/release/error).

evidence_idstring required
signaturestring required

Changes

No recorded changes to this operation across all 1 revision of this API.