---
title: "Read Actions collection."
method: GET
path: "/api/actions"
tags: ["Actions"]
---

# Read Actions collection.

`GET /api/actions`

*Actions* collection with items of the following *Task* types:
- `discoverThreadNetworksTask` **TODO**
- `addThreadDeviceTask`
- `getNetworkDiagnosticTask`
- `resetNetworkDiagCounterTask`
- `getEnergyScanTask`
- `updateDeviceCollectionTask`

The items contain all the attributes as given by a client in a POST request (values are not changed, except for timeout which counts down).
The items contain at least two additional server-added attributes (`id` and `status`); while the `id` must not change once assigned, the other server-added attributes may change according to the *Task* state.

Failing to parse the query parameter(s) leads to a 400 Bad Request Error.

## Response `200`

List of actions.

- union
  - object[]
  - object

## Other responses

- `400` — The client sent an invalid request. The client SHOULD perform action(s) to provide valid syntax before retrying the request.
- `406` — The client requests a content-type that is not supported by the target resource. The client SHOULD perform action(s) to re-align with the API before retrying the request.

## Changes

> 20 revisions in range; 1 could not be searched.

- **2026-08-21** `7996e8479177` — 1 breaking, 1 warning, 5 info
  - the `data/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - deleted the `header` request parameter `Accept`
  - added the optional property `data/items/relationships` to the response with the `200` status
  - removed `#/components/schemas/ActionsServer_addThreadDeviceTask, #/components/schemas/ActionsServer_getNetworkDiagnosticTask, #/components/schemas/ActionsServer_resetNetworkDiagCounterTask, #/components/schemas/ActionsServer_getEnergyScanTask, #/components/schemas/ActionsServer_updateDeviceCollectionTask` from the `data/items/` response property `anyOf` list for the response status `200`
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api/changes/api/actions/get.md)

---

[API](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api.md) · [All operations](https://skmtc.dev/openthread/apis/swagger-openthread-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openthread/swagger-openthread-rest-api/revisions/c3799941c155/schema)
