---
id: link-specification-snapshots-list
title: "List snapshots of a link specification"
description: "List the append-only snapshot history of a link specification, newest first. Snapshot ids are what package components pin as resource_revision_id."
sidebar_label: "List snapshots of a link specification"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/nullplatform-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List snapshots of a link specification"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/link_specification/{id}/snapshots"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List the append-only snapshot history of a link specification, newest first. Snapshot ids are what package components pin as resource_revision_id.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The specification id.","example":"7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f"},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":20}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The specification's snapshots.","content":{"application/json":{"schema":{"type":"object","properties":{"paging":{"type":"object","properties":{"offset":{"type":"integer","description":"The offset of this page.","example":0},"limit":{"type":"integer","description":"The maximum number of results in this page.","example":20}},"title":"paging"},"results":{"type":"array","items":{"type":"object","description":"Append-only snapshot of a specification at one change of its watched fields. The id is what a package component pins as resource_revision_id.","required":["id","specification_id","sequence_number","content_hash","content","created_at"],"properties":{"id":{"type":"string","format":"uuid","description":"The snapshot id. This is the value a package component pins as `resource_revision_id`.","example":"0c9e8d7f-6a5b-4c3d-8e2f-1a0b9c8d7e6f"},"specification_id":{"type":"string","format":"uuid","description":"The specification this snapshot belongs to.","example":"7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f"},"sequence_number":{"type":"integer","minimum":1,"description":"Per-specification counter; higher is newer.","example":3},"content_hash":{"type":"string","minLength":64,"maxLength":64,"description":"SHA-256 of the specification's watched fields. Identical content never mints a second snapshot in a row.","example":"4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945"},"content":{"type":"object","additionalProperties":true,"description":"The specification as it was when this snapshot was minted."},"created_by":{"type":"string","nullable":true,"description":"The user whose write minted the snapshot, or null.","example":"jane.doe@example.com"},"created_at":{"type":"string","format":"date-time","description":"When the snapshot was minted.","example":"2026-09-14T12:00:00.000Z"},"updated_at":{"type":"string","format":"date-time","description":"Snapshots are immutable, so this matches `created_at`.","example":"2026-09-14T12:00:00.000Z"}},"title":"specificationSnapshot"}}},"title":"specificationSnapshotListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Snapshot 9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d not found for specification 7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":400},"code":{"type":"string","example":"bad_request"},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"Snapshot 9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d not found for specification 7b2d1c5e-8f4a-4e3b-9c6d-1a2b3c4d5e6f"}},"title":"errorResponse"}}}}}}
>
  
</StatusCodes>