---
title: "Store the native session of a local mirror, so its owner's continuation resumes that exact conversation [write]"
method: POST
path: "/sessions/{id}/mirror/checkpoint"
---

# Store the native session of a local mirror, so its owner's continuation resumes that exact conversation \[write\]

`POST /sessions/{id}/mirror/checkpoint`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/sessions/{id}/mirror/checkpoint`
- Auth: HTTP bearer

Only for a session created with local_mirror, and only by its owner. Body {file_id, synced_at?}: synced_at is the syncedAt receipt from PUT /mirror before capturing the archive. Without it, continuation uses the synced messages. The file is an asteroids.native-checkpoint v1 ZIP of at most 16 MiB (the files Claude Code or Codex keep for the conversation) that the owner uploaded to their personal files. It is checked whole (400 checkpoint_invalid), must be this chat's own conversation on its own agent (409 checkpoint_mismatch), and replaces the checkpoint stored before. A continuation the owner starts on the same agent resumes it natively while nothing was synced after it; otherwise it continues from the synced messages. A file the caller did not upload personally answers 404; a session that is not a mirror 409 not_a_mirror_session, one already continued 409 continued_in_cloud, an archived one 410. Nothing runs and nothing is billed.

## Path parameters

- `id` string, required

## Request body

- object
  - `file_id` string, required
  - `synced_at` string, date-time

## Response `200`

Stored

- object
  - `sha256` string
  - `size_bytes` integer
  - `harness` 'claude_code' | 'codex'
  - `harness_version` string, nullable
  - `staged_at` string, date-time

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/mirror/checkpoint/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)