Get a retained version of a workspace JSON template

Returns the exact saved body of one retained template version as UTF-8 text, after checking that the template belongs to this scope. Take versionId from the versions list and URL-encode it. Read-only: it does not restore or modify the template. Returns 404 when the template, or that version of it, is not available. JSON templates have no instructions part: part=instructions returns 400. Requires admin rights in the workspace (workspace admin or superadmin, or an admin of an organization the clinic belongs to). Accepts a browser session or a personal API key; organization and workspace API keys (sk_org_…, sk_ws_…) get 403.

get/workspaces/{workspaceId}/data-export/json-templates/version

Request

Base URL
https://vetnio.com/api/v2
URL
https://vetnio.com/api/v2/workspaces/{workspaceId}/data-export/json-templates/version
Auth
HTTP bearer

Path parameters

workspaceIdstring required

Identifier of the workspace (clinic) to export. The caller must be an admin of it, directly or as an admin of its organization.

Example:furunculotic-loud-chihuahua

Query parameters

part'content' | 'instructions'

Which stored object of the template to read:

content — the template body itself.
instructions — the separate instructions object of an imported template (original wording and per-section instructions). Only workspace note and meeting templates have one; other kinds return 400.

Example:content

templateIdstring required

ID of the template, as returned in items[].id by the matching template export. It must belong to the workspace or organization in the path, otherwise 404.

Example:5b0d7a3e-2c41-4f0e-9a77-1f3c9e6b8d20

versionIdstring required

Opaque version ID from the versions list (versions[].versionId) or from artifact.currentVersionId. URL-encode it; it can contain characters such as +, / and =.

Example:3HL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY

Response

Successful response

currentVersionIdstring nullable required

Version ID of the template's current body at the time of the request, or null when there is no current body. Unlike artifact.currentVersionId, a legacy unversioned body is reported here as the literal string "null".

contentstring required

The exact retained body as UTF-8 text, including HTML instructions or the original JSON schema.

Example response

{
  "currentVersionId": "3HL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY",
  "version": {
    "isLatest": true,
    "lastModified": "2026-09-02T14:30:00.000Z",
    "size": 2048,
    "contentType": "text/html",
    "audit": {
      "id": "c4e1a7b2-9d3f-4e8a-b6c5-2f1e0d9c8b7a",
      "occurredAt": "2026-09-02T14:30:00.000Z",
      "actorName": "Dr. Sam Lee",
      "actorType": "user",
      "action": "template.content_updated",
      "s3VersionId": "3HL4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.