Skip to main content
GET
/
api
/
templates
/
{id}
/
versions
List Template Versions
curl --request GET \
  --url https://api.example.com/api/templates/{id}/versions

Documentation Index

Fetch the complete documentation index at: https://docs.spitshake.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Path parameters

​
id
string
required
Template ID (e.g., tpl_7VQhP2tM9xA1kR8bN).

​
Response

Returns an array of version snapshots, newest first (max 20). 
{
  "data": [
    {
      "id": 12,
      "version_number": 3,
      "field_count": 42,
      "change_summary": "Pre-update snapshot",
      "created_at": "2026-05-02T15:30:00Z"
    },
    {
      "id": 11,
      "version_number": 2,
      "field_count": 42,
      "change_summary": "Pre-update snapshot",
      "created_at": "2026-04-28T10:00:00Z"
    }
  ]
}
FieldTypeDescription
idintegerVersion ID. Use this with the Restore Version endpoint.
version_numberintegerSequential version number.
field_countintegerNumber of fields in the schema at this version.
change_summarystringDescription of what triggered the snapshot.
created_atstringISO 8601 timestamp when the snapshot was created.

​
Example

curl https://spitshake.io/api/templates/tpl_7VQhP2tM9xA1kR8bN/versions \
  -H "X-Auth-Token: YOUR_API_KEY"
Snapshots are created automatically before every PUT /api/templates/:id update and before submitter remapping. You don’t need to create them manually.