Create a test case

POST/projects/:project_id/test_cases

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

Create a new test case within a specified project.

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

PATH PARAMETERS

project_id Unique identifier of the project in which the test case is created.

REQUEST BODY

`title`	The title of the test case.
`description`	A detailed description of the test case.
`template_type`	The type of template used for the test case (e.g., TCD, STEPS).
`preconditions`	Preconditions that must be met before executing the test case.
`steps`	The steps to execute the test case.
`expected_results`	The expected results after executing the test case.
`type_id`	Identifier for the type of the test case.
`status_id`	Identifier for the current status of the test case.
`automation_type_id`	Identifier for the automation type of the test case.
`project_id`	Identifier of the project to which the test case belongs.
`priority_id`	Identifier for the priority level of the test case.
`owner_id`	Identifier of the user who owns the test case.
`reviewer_id`	Identifier of the user who will review the test case.
`folder_id`	Identifier of the folder where the test case will be stored.
`label_ids`	An array of labels associated with the test case.
`individual_steps`	An array of individual step objects for the test case.

RESPONSE ATTRIBUTES

`message`	A message indicating the result of the operation; usually empty on success.
`data.test_case.id`	Unique identifier for the created test case.
`data.test_case.title`	The title of the test case.
`data.test_case.description`	The description of the test case.
`data.test_case.template_type`	The type of template used for the test case.
`data.test_case.preconditions`	Preconditions for the test case.
`data.test_case.steps`	Steps to execute the test case.
`data.test_case.expected_results`	Expected results after execution.
`data.test_case.human_id`	Human-readable identifier for the test case.
`data.test_case.owner_id`	Identifier of the owner of the test case.
`data.test_case.type_id`	Identifier for the type of the test case.
`data.test_case.status_id`	Identifier for the status of the test case.
`data.test_case.automation_type_id`	Identifier for the automation type.
`data.test_case.priority_id`	Identifier for the priority level.
`data.test_case.reviewer_id`	Identifier for the reviewer of the test case.
`data.test_case.folder_id`	Identifier for the folder containing the test case.
`data.test_case.project_id`	Identifier of the project associated with the test case.
`data.test_case.created_at`	Timestamp of when the test case was created.
`data.test_case.updated_at`	Timestamp of the last update to the test case.

REQUEST

curl -X POST \
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_cases' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Attempt to book a flight with missing required fields",
    "description": "Attempt to book a flight with missing required fields",
    "template_type": "TCD",
    "preconditions": "User has selected a flight from the search results. User is on the booking page.",
    "steps": "Leave one or more required fields (e.g., First Name, Last Name, Email) blank. Click the 'Book Now' button.",
    "expected_results": "An error message is displayed indicating that the required fields are missing. The user is prompted to fill in the missing fields.",
    "type_id": "75a816d1-8909-47b5-b85b-fbf60a973587",
    "status_id": "bafd7f8d-832a-42ea-91df-9a1e5e02a2d9",
    "automation_type_id": "3cee45b5-4335-4564-bbdf-4ea9b0306ed3",
    "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
    "priority_id": "1d810f8f-7be0-41e4-9971-67ee1f55612e",
    "owner_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
    "reviewer_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
    "folder_id": "580e3972-7f4a-4748-87e6-9b74873e2b93",
    "label_ids": [
      "Flight_testcase"
    ],
    "individual_steps": []
  }'

const response = await fetch('https://test-management.testsigma.com/api/v1/projects/:project_id/test_cases', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "title": "Attempt to book a flight with missing required fields",
      "description": "Attempt to book a flight with missing required fields",
      "template_type": "TCD",
      "preconditions": "User has selected a flight from the search results. User is on the booking page.",
      "steps": "Leave one or more required fields (e.g., First Name, Last Name, Email) blank. Click the 'Book Now' button.",
      "expected_results": "An error message is displayed indicating that the required fields are missing. The user is prompted to fill in the missing fields.",
      "type_id": "75a816d1-8909-47b5-b85b-fbf60a973587",
      "status_id": "bafd7f8d-832a-42ea-91df-9a1e5e02a2d9",
      "automation_type_id": "3cee45b5-4335-4564-bbdf-4ea9b0306ed3",
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "priority_id": "1d810f8f-7be0-41e4-9971-67ee1f55612e",
      "owner_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "reviewer_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "folder_id": "580e3972-7f4a-4748-87e6-9b74873e2b93",
      "label_ids": [
          "Flight_testcase"
      ],
      "individual_steps": []
  })
});
const data = await response.json();

import requests

response = requests.post(
  'https://test-management.testsigma.com/api/v1/projects/:project_id/test_cases',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "title": "Attempt to book a flight with missing required fields",
      "description": "Attempt to book a flight with missing required fields",
      "template_type": "TCD",
      "preconditions": "User has selected a flight from the search results. User is on the booking page.",
      "steps": "Leave one or more required fields (e.g., First Name, Last Name, Email) blank. Click the 'Book Now' button.",
      "expected_results": "An error message is displayed indicating that the required fields are missing. The user is prompted to fill in the missing fields.",
      "type_id": "75a816d1-8909-47b5-b85b-fbf60a973587",
      "status_id": "bafd7f8d-832a-42ea-91df-9a1e5e02a2d9",
      "automation_type_id": "3cee45b5-4335-4564-bbdf-4ea9b0306ed3",
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "priority_id": "1d810f8f-7be0-41e4-9971-67ee1f55612e",
      "owner_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "reviewer_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "folder_id": "580e3972-7f4a-4748-87e6-9b74873e2b93",
      "label_ids": [
          "Flight_testcase"
      ],
      "individual_steps": []
  }
)
data = response.json()

RESPONSE201Created

{
  "message": "",
  "data": {
    "test_case": {
      "id": "9c09349f-5c16-4d29-9f8e-194576b6b841",
      "title": "Attempt to book a flight with missing required fields",
      "description": "Attempt to book a flight with missing required fields",
      "template_type": "TCD",
      "preconditions": "User has selected a flight from the search results. User is on the booking page.",
      "steps": "Leave one or more required fields (e.g., First Name, Last Name, Email) blank. Click the 'Book Now' button.",
      "expected_results": "An error message is displayed indicating that the required fields are missing. The user is prompted to fill in the missing fields.",
      "human_id": "DEMO-2",
      "owner_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "type_id": "75a816d1-8909-47b5-b85b-fbf60a973587",
      "status_id": "bafd7f8d-832a-42ea-91df-9a1e5e02a2d9",
      "automation_type_id": "3cee45b5-4335-4564-bbdf-4ea9b0306ed3",
      "priority_id": "1d810f8f-7be0-41e4-9971-67ee1f55612e",
      "reviewer_id": "cbbc40a5-26e9-4b88-8c27-3626c9fbdaa4",
      "folder_id": "580e3972-7f4a-4748-87e6-9b74873e2b93",
      "project_id": "c47ade67-0543-4582-a4a5-b7de447c94f5",
      "created_at": 1710675200,
      "updated_at": 1710675200
    }
  }
}