Skip to main content

Published Versions

List every published version of a Spec, newest first, with its content hash and which one is currently live on the schema.

Every publish appends an immutable version. This endpoint lists them newest first — this is where a Spec's "v3" lives.

Do not confuse this with GET /v1/schemas/{id}/versions, which reads the unrelated legacy schema-version counter. A Spec-authored schema never advances that counter, so that endpoint is normally empty for these schemas.
GET/v1/specs/{id}/versions

Path parameters

id*stringSpec UUID.

List versions

curl -H "Authorization: Bearer $TALONIC_API_KEY" \
  "https://api.talonic.com/v1/specs/e2144027-39c0-44e8-a196-72be1e360749/versions"

Response

Response fields

data[].versionintegerVersion number. Publishes only ever append.
data[].content_hashstringsha256 of the canonical Spec document. Identical hashes are identical Specs.
data[].created_atstringWhen the version was published (ISO 8601).
data[].is_materializedbooleanWhether this is the version currently live on the schema.

Response

{
  "data": [
    { "version": 3, "content_hash": "9f2c…", "created_at": "2026-04-25T14:30:00.000Z", "is_materialized": true },
    { "version": 2, "content_hash": "41ab…", "created_at": "2026-04-22T10:05:00.000Z", "is_materialized": false },
    { "version": 1, "content_hash": "c7d0…", "created_at": "2026-04-20T09:12:00.000Z", "is_materialized": false }
  ]
}

Exactly one version is normally flagged is_materialized. If none is, the Spec has been published but never converged onto a schema.

Related

Get a Spec
List Specs