---
title: "Create Snapshot"
method: POST
path: "/agent-loop/workspaces/{workspace_id}/snapshots"
tags: ["snapshots"]
---

# Create Snapshot

`POST /agent-loop/workspaces/{workspace_id}/snapshots`

## Path parameters

- `workspace_id` string, required

## Request body

- CreateSnapshotRequest
  - `parent_snapshot_id` string, required
  - `name` string, nullable

## Response `200`

Successful Response

- SnapshotResponse
  - `id` string, required
  - `document_artifact_id` string, required
  - `parent_snapshot_id` string, nullable, required
  - `turn_id` string, required
  - `kind` 'node' | 'capture', required
  - `status` 'draft' | 'committed' | 'discarded', required
  - `name` string, nullable, required
  - `created_at` string, date-time, required
  - `has_user_edits` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)