---
title: "Creates a new room for video verification (requesting the password of a share)"
method: POST
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/publicshareauth"
tags: ["files_integration"]
---

# Creates a new room for video verification (requesting the password of a share)

`POST /ocs/v2.php/apps/spreed/api/{apiVersion}/publicshareauth`

The new room is a public room associated with a "share:password" object with the ID of the share token. Unlike normal rooms in which the owner is the user that created the room these are special rooms always created by a guest or user on behalf of a registered user, the sharer, who will be the owner of the room.
The share must have "send password by Talk" enabled; an error is returned otherwise.

## Path parameters

- `apiVersion` 'v1', required

## Headers

- `OCS-APIRequest` boolean, required

## Request body

- object
  - `shareToken` string, required — Token of the file share

## Response `201`

Room created successfully

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` object, required
      - `token` string, required
      - `name` string, required
      - `displayName` string, required

## Other responses

- `404` — Share not found

---

[API](https://skmtc.dev/nextcloud/apis/spreed-full.md) · [All operations](https://skmtc.dev/nextcloud/apis/spreed-full/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nextcloud/spreed-full/revisions/41d6458d6d6e/schema)