Skip to main content
POST
Create a manual test case

Authorizations

Authorization
string
header
required

User PAT (td_pat_) scoped to the target project

Headers

Idempotency-Key
string

Optional but recommended on create (POST) requests. Send a unique value (e.g. a UUID) per logical create. A retry with the same key within 24h replays the original response instead of creating a duplicate. Same key with a different body returns 422 IDEMPOTENCY_KEY_REUSE; a key for a request still in flight returns 409. Omitting the header is allowed (no deduplication).

Path Parameters

projectId
string
required

The project identifier (e.g. project_abc123). Must match the project associated with your PAT.

Body

application/json
title
string
required
Maximum string length: 500
suiteName
string
required

Exact target suite name (case-sensitive). List suites first to get it.

Maximum string length: 255
description
string
status
string

Project-configured classification status.

testStepsDeclarationType
enum<string>
Available options:
Classic,
Gherkin
preconditions
string
postconditions
string
steps
object[]

Classic ({action, expectedResult, data}) or Gherkin ({event, stepDescription}) steps. Per-step attachments are not supported in v1.

Maximum array length: 100
priority
string
severity
string
type
string
layer
string
behavior
string
automationStatus
string
tags
string

Comma-separated tags.

flags
enum<string>[]
Available options:
To be Automated,
Is flaky,
Muted
customFields
object

Key-value strings. Keys must not start with $ or contain ..

Response

Test case created

success
enum<boolean>
Available options:
true
data
object
pagination
object