---
title: "Starts/stop an archiving operation."
method: POST
path: "/room/{roomName}/archive"
tags: ["Archives"]
---

# Starts/stop an archiving operation.

`POST /room/{roomName}/archive`

Starts or stops an archiving operation. Returns the information about the new recording, and inserts that information on the redis record associated to the room. Once a recording is in process, succesives call with operation=start are ignored and the existing record of the current archive is returned.

## Path parameters

- `roomName` string, required

## Response `200`

Information about the archive being recorded

## Other responses

- `400` — Unexpected error

## Changes

- **2015-11-09** `ac06be808ef7` — 2 warning, 1 info
  - deleted the `query` request parameter `operation`
  - deleted the `query` request parameter `userName`
  - added the non-success response with the status `400`
- **2015-10-15** `0e67ad107b9e` — 1 breaking
  - the `query` request parameter `userName` became required
- **2015-09-27** `fdd6b89fcde2` — 1 breaking, 2 info
  - added the new required `query` request parameter `operation`
  - added the new optional `query` request parameter `userName`
  - removed the non-success response with the status `400`

[Change history](https://skmtc.dev/opentok/apis/opentokrtc-api/changes/room/:roomName/archive/post.md)

---

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