Skip to content
TestsigmaDOCS
LoginBook a demo

Create a folder

POST/projects/{project_id}/folders

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

Creates a new folder within a project to organize test assets hierarchically.

Authenticate with your API key as a Bearer token in theAuthorization header. Generate a key →

PATH PARAMETERS

project_idUnique identifier of the project in which the folder is created.

REQUEST BODY

nameName of the folder to be created.
orderOrder in which the folder should be displayed.

RESPONSE ATTRIBUTES

messageStatus message for the request; may be empty.
data.folder.idUnique identifier of the created folder.
data.folder.nameName of the created 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 parent folder, if applicable.
data.folder.orderOrder index of the folder.
REQUEST
curl -X POST \
  'https://test-management.testsigma.com/api/v1/projects/{project_id}/folders' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Regression Suite",
    "order": 1
  }'
const response = await fetch('https://test-management.testsigma.com/api/v1/projects/{project_id}/folders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "name": "Regression Suite",
      "order": 1
  })
});
const data = await response.json();
import requests

response = requests.post(
  'https://test-management.testsigma.com/api/v1/projects/{project_id}/folders',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "name": "Regression Suite",
      "order": 1
  }
)
data = response.json()
RESPONSE201 Created
{
  "message": "",
  "data": {
    "folder": {
      "id": "a1f3c2d8-7b4e-4f91-9c2a-6e8d5b3a1c47",
      "name": "Regression Suite",
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "children": [],
      "parent_folder_id": "",
      "order": 1
    }
  }
}