---
title: "Clone Recorder"
method: POST
path: "/recorder/clone"
tags: ["Recorder/Survey"]
---

# Clone Recorder

`POST /recorder/clone`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/recorder/clone`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

**Clone Recorder to copy all the settings from the existing recorders**

**All the required fields are as below:**

`recorderId` - Pass the recorderId from the existing recorder

**Optional:**

`name` - New name for the recorder. If not pass, it will take the existing recorder name and add `(clone)` to the new recorder

`description` - New description for the recorder. If not pass, it will take the existing recorder description as is.

`folderId` - IMPORTANT! We recommend to pass the `folderId` to ensure the recordings save in the specific folder. If not pass, it will take the existing recorder folderId setting.

---

If you need to change any other settings, we recommend to use the `Create Recorder` API call.

## Request body

- object
  - `recorderId` string, required: Name the recorder you want to copy. Required. An empty or whitespace-only value is rejected. A recorderId that matches no recorder returns 404 with 'Recorder not found'.
  - `name` string: Name the copy. Optional, empty string allowed. If you leave it out or send an empty string, the copy is named after the source recorder with ' (Clone)' appended.
  - `description` string: Describe the copy. Optional, empty string allowed. If you leave it out or send an empty string, the copy inherits the source recorder's description.
  - `folderId` string: Put the copy in this folder. Optional, empty string allowed. If you leave it out or send an empty string, the copy stays in the source recorder's folder. A folderId that matches no folder returns 404 with 'Folder not found. Please create or select a valid folder Id.'

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `recorderData` object
      - `notification` object
        - `upload` boolean
        - `client` boolean
      - `recordings` unknown[]
        - unknown
      - `minDuration` integer
      - `maxDuration` integer
      - `privacyMode` string
      - `password` string
      - `isAutoAnalyze` boolean
      - `assignTo` string
      - `folderId` string
      - `sourceLanguage` string
      - `isActive` boolean
      - `isDisabled` boolean
      - `isDeleted` boolean
      - `_id` string
      - `name` string
      - `description` string
      - `companyId` string
      - `userId` string
      - `recorderId` string
      - `token` string
      - `meta` object
        - `backgroundImg` string
        - `logo` string
        - `primaryColor` string
        - `type` object
          - `audio` boolean
          - `video` boolean
          - `screenShare` boolean
          - `upload` object
            - `file` boolean
            - `multiple` boolean
            - `text` boolean
        - `client` object
          - `name` boolean
          - `email` boolean
          - `questions` unknown[]
            - unknown
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `__v` integer
    - `recorderId` string
    - `token` string

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)