---
id: action-specification-snapshots-list
title: "List snapshots of an action specification"
description: "List the append-only snapshot history of an action specification, newest first. Snapshot ids are what package components pin as resource_revision_id."
sidebar_label: "List snapshots of an action 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 an action specification"}
>
</Heading>

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



List the append-only snapshot history of an action 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>