Run Cards

Project an accepted-run proof into immutable distribution objects.

Loads the same replay-validated accepted-run proof authority as the recorded proof route, then emits a deterministic badge, social-card image, share packet, or MCP result. A stale, revoked, retracted, or otherwise downgraded proof is never projected as verified.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

Example setup. Use an identifier returned by the matching list, search or create operation. Sample identifiers are not a promise that a record exists.

get/api/run-proof-distribution/{proofId}

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/run-proof-distribution/{proofId}
  • Auth: none required

Path parameters

proofIdstring required

Query parameters

format'badge' | 'og' | 'share' | 'mcp'

Headers

If-None-Matchstring

Exact strong ETag for the requested representation.

Response

Deterministic proof-bound distribution object

schema'hugging-bay.accepted-run-proof.distribution.v1' required
version'1.0.0' required
kind'share-card' required
proofIdstring required
proofDigeststring required
status'current' | 'expired' | 'stale' | 'superseded' | 'revoked' | 'retracted' required
projectionState'verified' | 'blocked' required
evidenceCutoffstring date-time required
canonicalUrlstring uri required
contentDigeststring required
etagstring required
overlinestring required
headlinestring required
subheadlinestring required
statusLinestring required
hardwareClassstring required
evidenceStrengthstring required
accentColorstring required
widthunknown required
heightunknown required

Changes

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