---
title: "Get template revision history"
method: GET
path: "/templates/revisions/{uid}"
tags: ["Templates"]
---

# Get template revision history

`GET /templates/revisions/{uid}`

Paginated edit history for a form template. Each entry may include a v1 change record (`version`, `scope`, `summary`, `patch`) describing template JSON changes.

## Path parameters

- `uid` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

successful operation

- object
  - `status` string
  - `data` TemplateRevisionHistoryResponse
    - `total` integer
    - `limit` integer
    - `offset` integer
    - `found` integer
    - `history` TemplateRevisionHistoryEntry[]
      - `id` integer
      - `obj_type` string
      - `obj_id` integer
      - `user_id` integer
      - `action_type` string — Audit action (e.g. update, patch)
      - `created` string, date-time
      - `metadata` union
        - MetadataChangeRecordV1 — Metadata change payload stored in audit log entries for saves that produced a diff. When diff computation fails, `status` is `diff_failed` and `before`/`after` contain normalized snapshots.
          - `version` integer
          - `scope` 'study_metadata' | 'admin_metadata' | 'template'
          - `summary` MetadataChangeSummary
            - `added` integer
            - `removed` integer
            - `replaced` integer
          - `patch` MetadataChangePatchItem[]
            - `op` 'add' | 'remove' | 'replace'
            - `path` string — JSON Pointer path (RFC 6901)
            - `old` unknown
            - `new` unknown
          - `status` 'diff_failed'
          - `error` string
          - `before` object
          - `after` object
        - object
      - `username` string, nullable

## Other responses

- `400` — Bad request

## Changes

- **2026-07-01** `7c5b5e29106b` — 1 info
  - endpoint added
- **2026-02-23** `5bfc4d9dc1c8` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/worldbank/apis/metadata-editor-api/changes/templates/revisions/:uid/get.md)

---

[API](https://skmtc.dev/worldbank/apis/metadata-editor-api.md) · [All operations](https://skmtc.dev/worldbank/apis/metadata-editor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/worldbank/metadata-editor-api/revisions/f4c8258bab5a/schema)