REST API
REST API
Authenticated HTTP endpoints over the same deterministic service as MCP.
Base URL:
https://erratalabs.devEvery /v1/* request requires:
Authorization: Bearer $ERRATA_API_KEYHealth
| Method | Path | Authentication | Purpose |
|---|---|---|---|
GET | /livez | No | Process liveness. |
GET | /readyz | No | Release-aware readiness. |
GET | /health | No | Alias of readiness. |
GET | /healthz | No | Alias of readiness. |
Catalog and facts
| Method | Path | Purpose |
|---|---|---|
GET | /v1/catalog/search?q=STM32C011D6YXTR | Search selector parts and ordering codes. |
GET | /v1/catalog/part?part=STM32C011D6 | Inspect one selector part and its sources. |
GET | /v1/parts/resolve?q=STM32F407VGT6 | Resolve a verified-fact target. |
GET | /v1/context?part=...&topic=... | Retrieve one bounded fact topic. |
GET | /v1/release | Inspect the promoted immutable release. |
GET | /v1/coverage?part=STM32F407VGT6 | Inspect verified coverage for a part. |
GET | /v1/sources?part=STM32F407VGT6 | Inspect source artifacts and trust metadata. |
Only GET is accepted for /v1 routes. Other methods return 405.
Examples
Resolve a part:
curl --fail \
-H "Authorization: Bearer $ERRATA_API_KEY" \
'https://erratalabs.dev/v1/parts/resolve?q=STM32F407VGT6'Retrieve package-filtered USART3 pins:
curl --fail \
-H "Authorization: Bearer $ERRATA_API_KEY" \
'https://erratalabs.dev/v1/context?part=STM32F407VGT6&topic=pins&peripheral=USART3&package=LQFP100&limit=20'Inspect the live release:
curl --fail \
-H "Authorization: Bearer $ERRATA_API_KEY" \
'https://erratalabs.dev/v1/release'MCP endpoint
POST /mcp serves stateless Streamable HTTP MCP. Use an MCP SDK or client configuration when possible; raw JSON-RPC calls are primarily useful for transport diagnostics.