---
title: "Create replay (screenshot or video)"
method: POST
path: "/api/v1/replays"
tags: ["Replays"]
---

# Create replay (screenshot or video)

`POST /api/v1/replays`

## Request

- Base URL: `https://session-replay.com`
- URL: `https://session-replay.com/api/v1/replays`
- Auth: none declared

Create a new replay. Supports three authentication methods: Site API Key (recommended), JWT token, or anonymous. Two types supported: 'screenshot' for quick snapshots with basic metadata, 'video' for full session recordings with extended metadata. The whole request may not exceed 600 MB. One that does, or one that declares no length, is refused with 413 and the error code 'replay_too_large' before anything is stored, and the accompanying detail is written to be shown to the person reporting the bug.

## Headers

- `X-Site-API-Key` string
- `Authorization` string

## Response `201`

video replay created with extended metadata

## Other responses

- `401`: invalid API key
- `413`: upload larger than the size ceiling
- `422`: invalid request

---

[API](https://skmtc.dev/session-replay/apis/session-replay-api.md) · [All operations](https://skmtc.dev/session-replay/apis/session-replay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/session-replay/apis/session-replay-api/revisions/120e5613bf95?raw)