---
title: "Create RUM replay session watch"
method: POST
path: "/api/v2/rum/replay/sessions/{session_id}/watches"
tags: ["Rum Replay Viewership"]
---

# Create RUM replay session watch

`POST /api/v2/rum/replay/sessions/{session_id}/watches`

Record a session watch.

## Path parameters

- `session_id` string, required

## Request body

- Watch — A single RUM replay session watch resource returned by create operations.
  - `data` WatchData, required — Data object representing a session watch record, including its identifier, type, and attributes.
    - `attributes` WatchDataAttributes — Attributes for recording a session watch event, including the application, event reference, and timestamp.
      - `application_id` string, required — Unique identifier of the RUM application containing the session.
      - `data_source` string — Data source type indicating the origin of the session data (e.g., rum or product_analytics).
      - `event_id` string, required — Unique identifier of the RUM event that was watched.
      - `timestamp` string, date-time, required — Timestamp when the session was watched.
    - `id` string — Unique identifier of the watch record.
    - `type` 'rum_replay_watch', required — Rum replay watch resource type.

## Response `201`

Created

- Watch — A single RUM replay session watch resource returned by create operations.
  - `data` WatchData, required — Data object representing a session watch record, including its identifier, type, and attributes.
    - `attributes` WatchDataAttributes — Attributes for recording a session watch event, including the application, event reference, and timestamp.
      - `application_id` string, required — Unique identifier of the RUM application containing the session.
      - `data_source` string — Data source type indicating the origin of the session data (e.g., rum or product_analytics).
      - `event_id` string, required — Unique identifier of the RUM event that was watched.
      - `timestamp` string, date-time, required — Timestamp when the session was watched.
    - `id` string — Unique identifier of the watch record.
    - `type` 'rum_replay_watch', required — Rum replay watch resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)