---
title: "Create a test case"
method: POST
path: "/api/v1/test/create"
tags: ["Tests"]
---

# Create a test case

`POST /api/v1/test/create`

Create a new test case in a project

## Request body

- object
  - `title` string, required
  - `description` string, nullable
  - `sectionId` integer, nullable
  - `new_section` string, nullable — Create a new section (use ">" for nested sections)
  - `projectId` integer, required
  - `squadId` integer, nullable
  - `new_squad` string, nullable
  - `preConditions` string, nullable
  - `steps` string, nullable
  - `expectedResult` string, nullable
  - `priorityId` integer, required
  - `typeId` integer, nullable
  - `automationStatusId` integer, required
  - `testCoveredById` integer, nullable
  - `platformId` integer, nullable
  - `labelIds` integer[], required
  - `jiraTicket` string, nullable
  - `defects` string, nullable
  - `automationId` string, nullable
  - `additionalGroups` string, nullable

## Response `200`

Test created successfully

- object
  - `data` object
    - `testId` integer
    - `testTitle` string
    - `message` string
  - `status` integer

---

[API](https://skmtc.net/dream-horizon-org/apis/checkmate-test-management-api.md) · [All operations](https://skmtc.net/dream-horizon-org/apis/checkmate-test-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dream-horizon-org/checkmate-test-management-api/versions/f818f4b6fb31/schema)