REST API (v2)

GET /schemas

List registered DTPR schema versions.

GET /schemas

Start here when discovering which versions are available. Returns the same versions[] array that schemas/index.json publishes.

Summary

Enumerates every registered schema version and its stability status. Not version-scoped — no DTPR-Content-Hash header is set.

Request

GET https://api.dtpr.io/api/v2/schemas

No query parameters.

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "ok": true,
  "versions": [
    {
      "id": "ai@2026-04-16-beta",
      "status": "beta",
      "content_hash": "sha256-…",
      "aliases": ["ai@latest"]
    }
  ]
}

Errors

Code	HTTP	Meaning
`upstream_error`	502	Schema index read failed. Retry.
`internal_error`	500	Unexpected server error.

Example

curl -s https://api.dtpr.io/api/v2/schemas

GET /api/v2/schemas HTTP/1.1
Host: api.dtpr.io

GET /schemas

GET /schemas

Summary

Request

Response

Errors

Example

See also