Skip to content
Testsigma DOCS

Move a folder

POST/projects/:project_id/folders/:folder_id/move

Base URL  https://test-management.testsigma.com/api/v1

Moves a folder within a project to a new parent folder.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
project_idUnique identifier of the project that contains the folder.
folder_idUnique identifier of the folder to move.
parent_folder_idIdentifier of the new parent folder to which the folder will be moved.
messageStatus message for the request; may be empty.
data.folder.idUnique identifier of the moved folder.
data.folder.nameName of the moved folder.
data.folder.project_idIdentifier of the project to which the folder belongs.
data.folder.childrenArray of child folders, if any.
data.folder.parent_folder_idIdentifier of the new parent folder.
data.folder.orderOrder index of the folder within the parent folder.
REQUEST
curl -X POST \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/folders/:folder_id/move' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "parent_folder_id": "c69216e0-e2a9-401f-9e08-77176abce8c4"
  }'
const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/folders/:folder_id/move', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "parent_folder_id": "c69216e0-e2a9-401f-9e08-77176abce8c4"
  })
});
const data = await response.json();
import requests

response = requests.post(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/folders/:folder_id/move',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "parent_folder_id": "c69216e0-e2a9-401f-9e08-77176abce8c4"
  }
)
data = response.json()
RESPONSE200OK
{
  "message": "",
  "data": {
    "folder": {
      "id": "c7db032b-d7ca-413b-8bff-74073e9618c4",
      "name": "Smoke Tests",
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "children": [],
      "parent_folder_id": "c69216e0-e2a9-401f-9e08-77176abce8c4",
      "order": 1
    }
  }
}