test-cases

Create a test case

Create a new test case with an initial version snapshot.

post/v1/test-cases

Request

Base URL
https://api.qualgent.ai
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/qualgent/apis/qualgent-api-service/docs/v1/test-cases/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

x-api-keystring

Request body

namestring required

Test case name

expected_resultstring required

Expected result after executing steps

prioritystring nullable

Priority level

descriptionstring nullable

Optional description

category_idstring nullable

Category ID to assign

change_sourcestring nullable

Origin of the change (e.g. 'api', 'mcp')

file_idsstring[] nullable

Legacy test-file attachment IDs. Used with null descriptions.

Example request

{
  "steps": [
    {
      "kind": "setup"
    }
  ],
  "priority": "Low",
  "variables": [
    {
      "name": "branch",
      "type": "string"
    }
  ]
}

Response

Test case created

idstring required

Created test case ID

namestring required

Test case name

version_idstring required

Initial version ID

Example response

{
  "warnings": [
    {
      "code": "undeclared_reference"
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.