REST API (v2)

GET /schemas/:version/manifest

Fetch the manifest for one schema version.

GET /schemas/:version/manifest

The manifest is the smallest document that uniquely identifies a version — title, description, status, and content_hash.

Summary

Returns the manifest for a single schema version. Sets DTPR-Content-Hash and Cache-Control.

Request

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

Path param	Description
`version`	Canonical schema version (e.g. `ai@2026-04-16-beta`) or alias (`ai@latest`).

Response

HTTP/1.1 200 OK
Content-Type: application/json
DTPR-Content-Hash: sha256-…
Cache-Control: no-store

{
  "ok": true,
  "manifest": {
    "id": "ai@2026-04-16-beta",
    "status": "beta",
    "content_hash": "sha256-…",
    "title": [{"locale":"en","value":"DTPR for AI (beta)"}],
    "description": [{"locale":"en","value":"…"}]
  }
}

Stable versions are served with Cache-Control: public, max-age=86400, immutable; beta versions with Cache-Control: no-store so authoring iterations land immediately.

Errors

Code	HTTP	Meaning
`bad_request`	400	Malformed `:version`.
`not_found`	404	Version is not registered.

Example

curl -s -i https://api.dtpr.io/api/v2/schemas/ai@2026-04-16-beta/manifest

GET /api/v2/schemas/ai@2026-04-16-beta/manifest HTTP/1.1
Host: api.dtpr.io

GET /schemas/:version/manifest

GET /schemas/:version/manifest

Summary

Request

Response

Errors

Example

See also