---
title: "Move tests into a folder"
method: POST
path: "/tests/folders/move"
---

# Move tests into a folder

`POST /tests/folders/move`

File several tests into a folder at once, or unfile them with `folderId: null`. Ids that no longer exist are skipped rather than failing the call, and a test already in that folder is left alone. To move a single test, `PATCH /tests` takes `folderId` too.

## Request body

- MoveTests
  - `testIds` string[], required — The tests to file. Ids that no longer exist are skipped and reported back.
  - `folderId` string, nullable — The destination folder, or `null` to take the tests out of their folders.

## Response `200`

Successful response

- object
  - `message` string
  - `movedTestIds` string[] — Tests that changed folder.
  - `unchangedTestIds` string[] — Tests that were already in that folder.
  - `skippedTestIds` string[] — Ids that do not belong to any test in this organisation.

## Other responses

- `404` — The destination folder does not exist, or none of the ids match a test in this organisation.

---

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