Update test case

patch

https://api.qase.io/v1/case/{code}/{id}

This method updates a test case.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

code

string

required

length between 2 and 10

Code of project, where to search entities.

integer

required

Identifier.

Body Params

description

string

preconditions

string

postconditions

string

title

string

length ≤ 255

severity

integer

priority

integer

behavior

integer

type

integer

layer

integer

is_flaky

integer

suite_id

int64

milestone_id

int64

automation

integer

deprecated

Deprecated, use isManual and isToBeAutomated instead. Encodes the test case automation state as a single integer: 0 = manual, 1 = manual planned to be automated, 2 = automated. If both automation and isManual/isToBeAutomated are provided, isManual and isToBeAutomated take precedence.

isManual

integer

1 if the case is manual, 0 if it is automated. Combined with isToBeAutomated, replaces the deprecated automation field.

isToBeAutomated

integer

1 if a manual case is planned to be automated, 0 otherwise. Only meaningful when isManual = 1; ignored when isManual = 0.

status

integer

steps_type

string

enum

Defaults to classic

Determines the format of the steps field. When "classic", steps use the standard action/expected_result/data format. When "gherkin", steps use the {value: "Given...\nWhen...\nThen..."} format.

Allowed:

attachments

array of strings

A list of Attachment hashes.

attachments

steps

array of objects

steps

tags

params

object | null

deprecated

Deprecated, use parameters instead.

parameters

array of objects | null

parameters

custom_field

object

Custom field values keyed by the field's project-scoped internal_id (see GET /custom_field). Values are always scalar strings; arrays, objects or non-scalars are rejected.

Field type	Value format	Example
`string`, `text`	Plain string	`"hello"`
`number`	Numeric string	`"42"`
`url`	Valid URL	`"https://qase.io"`
`datetime`	Absolute date (ISO 8601 recommended)	`"2026-04-29T15:00:00Z"`
`selectbox`, `radio`	Option `id` as string	`"1"`
`multiselect`	Comma-separated option `id`s (no spaces)	`"1,2,3"`
`checkbox`	`"1"` to check, `""` to uncheck	`"1"`
`user`	Team member `internal_id` as string	`"42"`

Partial update: only fields present in the payload are validated; required fields not included are not enforced. Send "" to clear a value. Unknown internal_ids are rejected; option-based values must reference an existing option.

Note: a required checkbox without a default cannot be unchecked via the API — set a default or clear required in workspace settings.

Responses

400

Bad Request.

401

Unauthorized.

403

Forbidden.

404

Not Found.

422

Unprocessable Entity.

429

Too Many Requests.

200A Test Case.