---
title: "Create or update a recording (upsert by client_id)"
method: POST
path: "/api/v1/cwa/recordings"
tags: ["CWA"]
---

# Create or update a recording (upsert by client_id)

`POST /api/v1/cwa/recordings`

## Request

- Base URL: `https://toolkit.browserstack.com`
- URL: `https://toolkit.browserstack.com/api/v1/cwa/recordings`
- Auth: API key in cookie `_wdt_rails_session`

Create or update a recording keyed on the extension client_id.

## Request body

- object
  - `client_id` string, required
  - `recording_name` string
  - `created_via` string
  - `url` string
  - `current_domain` string
  - `steps` object[]

## Response `201`

Recording created

- object
  - `success` boolean
  - `data` object

---

[API](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api.md) - [All operations](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api/llms.txt) - [OpenAPI document](https://skmtc.dev/birdeatsbug/apis/wdt-rails-api/revisions/cbd06b547b6a?raw)