Skip to content

GET /api/v1/specs/{spec_id}

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

Get Spec

: detail with frontmatter, body, sections, tests_status.

Auth: Authorization: Bearer <token> required

Terminal window
curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/specs/<spec_id>" \
-H "Authorization: Bearer <token>"

The contract carries no example for this response; schema: SpecDetailResponse. Field-level shape: interactive explorer.

SpecDetailResponse — Successful Response

FieldTypeDescription
body_markdownstring
frontmatterobject
idstring
sectionsarray of SectionAnchor
tests_statusarray of TestStatus
ParameterInRequiredTypeDefaultConstraintsDescription
spec_idpathyesstring——
CodeMeaningBody
400Malformed spec id (expected SPEC-NNN)—
401Missing or invalid authentication credentialsErrorResponse
404Spec not found—
422Validation ErrorHTTPValidationError

Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.