Source code
Revision control
Copy as Markdown
Other Tools
# REST API - [WAVE Test Runner](../README.md)
The REST API allows the WAVE server to be integrated into other systems. Every
call must be preceded with a namespace or web root, which is omitted in this
documentation. The default web root is `/_wave`, which can be changed in the
config.json using the keyword `web_root`.
Additional [REST API Guides](./guides/README.md) can help to understand how to
use these endpoints in context.
## Sessions API <a name="sessions-api"></a>
| Name | Description |
| -------------------------------------------------- | -------------------------------------------------------------- |
| [`create`](./sessions-api/create.md) | Creates a new test session. |
| [`read session`](./sessions-api/read.md) | Reads a sessions configuration. |
| [`read sessions`](./sessions-api/read_sessions.md) | Reads all session tokens, expandable with configs and statuses |
| [`read public`](./sessions-api/read-public.md) | Reads all public sessions tokens. |
| [`update`](./sessions-api/update.md) | Updates a session configuration. |
| [`delete`](./sessions-api/delete.md) | Deletes a test session. |
| [`status`](./sessions-api/status.md) | Reads the status and progress of a session. |
| [`start`](./sessions-api/control.md#start) | Starts a test session. |
| [`stop`](./sessions-api/control.md#stop) | Stops a test session. |
| [`pause`](./sessions-api/control.md#pause) | Pauses a test session. |
| [`find`](./sessions-api/find.md) | Finds a session token by providing a token fragment. |
| [`labels`](./sessions-api/labels.md) | Attach labels to sessions for organization purposes. |
| [`listen events`](./sessions-api/events.md) | Register for sessions specific events. |
| [`push events`](./sessions-api/events.md) | Push session specific events. |
## Tests API <a name="tests-api"></a>
| Name | Description |
| --------------------------------------------------------------- | ------------------------------------------------------ |
| [`read all`](./tests-api/read-all.md) | Reads all tests available. |
| [`read session`](./tests-api/read-session.md) | Reads all tests that are part of a session. |
| [`read next`](./tests-api/read-next.md) | Reads the next test to run in a session. |
| [`read last completed`](./tests-api/read-last-completed.md) | Reads the last completed tests of a session. |
| [`read malfunctioning`](./tests-api/read-malfunctioning.md) | Reads the list of malfunctioning tests of a session. |
| [`update malfunctioning`](./tests-api/update-malfunctioning.md) | Updates the list of malfunctioning tests of a session. |
| [`read available apis`](./tests-api/read-available-apis.md) | Reads all available APIs names and paths. |
## Results API <a name="results-api"></a>
| Name | Description |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| [`create`](./results-api/create.md) | Create a new test result for a test in a session. |
| [`read`](./results-api/read.md) | Read all test results of a session. |
| [`read compact`](./results-api/read-compact.md) | Read the number of passed, failed, timed out and not run tests of a session. |
| [`import session`](./results-api/import.md#1-import-session) | Import session results. |
| [`import api results`](./results-api/import.md#2-import-api-results) | Import results of a specific API into existing session. |
| [`download`](./results-api/download.md#1-download) | Download all session results to import into other WMATS instance. |
| [`download api`](./results-api/download.md#2-download-api) | Download all results of an API. |
| [`download all apis`](./results-api/download.md#3-download-all-apis) | Download all results of all APIs. |
| [`view report`](./results-api/download.md#4-download-report) | View the WPT report of an API of a session. |
| [`view multi report`](./results-api/download.md#5-download-multi-report) | View the WPT report of an API of multiple sessions. |
| [`download overview`](./results-api/download.md#6-download-overview) | Download an overview of results of all APIs of a session. |
| [`view report`](./results-api/view.md#1-view-report) | Read an url to a hosted version of a WPT report for an API of a session. |
| [`view multi report`](./results-api/view.md#2-view-multi-report) | Read an url to a hosted version of a WPT report for an API of multiple session. |
## Devices API <a name="devices-api"></a>
| Name | Description |
| -------------------------------------------------------------------- | -------------------------------------- |
| [`create`](./devices-api/create.md) | Registers a new device. |
| [`read device`](./devices-api/read-device.md) | Read information of a specific device. |
| [`read devices`](./devices-api/read-devices.md) | Read a list of all available devices. |
| [`register event listener`](./devices-api/register.md) | Register for a device specific event. |
| [`send event`](./devices-api/send-event.md) | Sends a device specific event. |
| [`register global event listener`](./devices-api/register-global.md) | Register for a global device event. |
| [`send global event`](./devices-api/send-global-event.md) | Sends a global device event. |
## General API <a name="general-api"></a>
| Name | Description |
| ----------------------------------- | ---------------------------------------------------- |
| [`status`](./general-api/status.md) | Returns information on how the server is configured. |