# Get Team Run Checkpoint Snapshot (/reference-api/schema/teams/get-team-run-checkpoint-snapshot)

## Team storage and identity [#team-storage-and-identity]

Use the database-backed [example Team server](/reference-api/schema/teams/create-team-run#example-team-server). Keep the Team run's returned `run_id` and `session_id`; a nested member run is not interchangeable with the Team run. Stored run, checkpoint and session operations require the configured database.

JWT user isolation is opt-in; non-admin service-account PAT callers always self-scope. Scoped callers need their own matching Team session and run, while configured resource authorization also applies. Run and checkpoint lookups return **404** for inaccessible or mismatched records. For factories, retain any `factory_input` needed by endpoints that reconstruct the Team.

## Select the message boundary [#select-the-message-boundary]

First call [List Team Run Checkpoints](/reference-api/schema/teams/list-team-run-checkpoints). Use an entry's **`message_index`** in this path, not its `checkpoint_id` display label. The same boundary is named `continue_from` when continuing a run.

The snapshot is derived from a copy and does not rewrite the stored run. Safe truncation around tool-call/result pairs can return fewer messages than the requested boundary, while the checkpoint metadata still names that requested boundary. Inspect the returned messages before using the snapshot as a transcript.

## `GET /teams/{team_id}/runs/{run_id}/checkpoints/{message_index}`

**Summary:** Get Team Run Checkpoint Snapshot

**Description:** Return a derived team run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run.

### Authentication

- Option 1: `HTTPBearer` — HTTP bearer

### Parameters
- `message_index` (path; integer; required)
- `run_id` (path; string; required)
- `team_id` (path; string; required)
- `session_id` (query; string; required) — Session ID for the run

### Request body

None.

### Responses

#### `200`

Run checkpoint snapshot retrieved successfully

**`application/json`**

Type `unspecified`.

#### Other responses

- `400` — Invalid checkpoint message index `application/json`: Schema `BadRequestResponse` (object).
- `401` — Unauthorized `application/json`: Schema `UnauthenticatedResponse` (object).
- `404` — Team or run not found `application/json`: Schema `NotFoundResponse` (object).
- `422` — Validation Error `application/json`: Schema `ValidationErrorResponse` (object).
- `500` — Internal Server Error `application/json`: Schema `InternalServerErrorResponse` (object).