summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/tools/wave/docs/rest-api/devices-api/create.md
blob: 5ed1355ad2f034ef67514208348c7f89d607b242 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# `create` - [Devices API](../README.md#devices-api)

The `create` method of the devices API registers a new devices to remotely 
start test sessions on. The device will automatically be unregistered if its 
not registering for an [event](./register.md) for more than a minute.

## HTTP Request

`POST /api/devices`

## Response Payload

```json
{
    "token": "<String>"
}
```

- **token** specifies the handle to reference the registered device by.

## Example

**Request:**

`POST /api/devices`

**Response:**

```json
{
    "token": "e5f0b92e-8309-11ea-a1b1-0021ccd76152"
}
```