Update test-case content

put

https://{tenant}.katalon.io/v2/tm/test-cases/{id}/contents/{contentType}

Replaces manual content for a case in the authenticated project.
VERSION checks that versionNumber still matches the latest version; a stale base returns 409.
REF needs refType and refName. Omit mode for LATEST.
Writes can target only the configured default repository ref; other refs return 400.
The repository must support versioned authoring and accept the content and workspace selection.
Repository state, credentials, and readiness can prevent the write.
A taskResource can describe queued publication; HTTP 200 does not mean repository publication has finished.
Requires the TestCase:Update permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

int64

required

ID of the requested test asset.

contentType

string

enum

required

Content type. Only MANUAL is supported.

Allowed:

Body Params

message

string

Publication message; a blank value uses Update manual test case content.

workspaceId

int64

Optional repository workspace ID.

mode

string | null

enum

Defaults to LATEST

Base selector for the write; null also selects LATEST.

Allowed:

versionNumber

integer

Required for VERSION; must match the latest version.

refType

string

enum

Send BRANCH with refName for REF mode; writes support only the configured default repository ref.

Allowed:

refName

string

Configured default repository ref name for writes. Required for REF mode; other refs return 400.

content

string

required

Complete manual flow JSON; call-step validation also applies.

Headers

x-account-id

string

Optional account UUID for selecting account context explicitly.

x-organization-id

int64

Optional organization ID for selecting organization context explicitly.

x-project-id

int64

required

True Platform project ID, not a repository ID.

Responses

401

Authentication is missing or invalid.

403

The caller lacks access or the required permission.

404

The requested asset was not found. Some inaccessible or deleted assets can instead return 400 or 403.

default

The request could not be completed. Inspect the response before retrying a mutation.

Language

Credentials

Basic

base64

URL

Loading…

Response

Choose an example:

application/json

200The content revision and any workspace or publication task.

400Missing content; unsupported type; incomplete VERSION or REF selector; invalid manual flow; or unavailable versioned authoring. A non-default write ref returns Only the configured default repository ref can be updated.

409The explicit base version is not the latest version.

422Call steps require UUID IDs without duplicates. Invalid URIs, missing callees or versions, cross-project targets, and circular references also fail validation.