Creates, updates, moves, or deletes test cases, test suites, and folders.
Send an array of repository objects, each with at most 20 testEntities.
Set testProjectId explicitly. If you omit it, the default Cloud
repository is selected or created.
| Resource | Action | data fields | Permission |
|---|---|---|---|
TEST_CASE | CREATE | name; parent path (blank defaults to Test Cases) | TestCase:Create |
TEST_CASE | UPDATE | id and the fields to change | TestCase:Update |
TEST_CASE | RENAME | id, new name | TestCase:Update |
TEST_CASE | MOVE | id, destination parent path | TestCase:Update |
TEST_CASE | DUPLICATE | id | TestCase:Create |
TEST_CASE | DELETE | id | TestCase:Delete |
TEST_SUITE | CREATE | name, parent path | TestSuite:Create |
TEST_SUITE | UPDATE | id, complete testSuiteItems list | TestSuite:Update |
TEST_SUITE | ADD_TEST_CASES | id, testSuiteItems to add | TestSuite:Update |
TEST_SUITE | RENAME | id, new name | TestSuite:Update |
TEST_SUITE | MOVE | id, destination parent path | TestSuite:Update |
TEST_SUITE | DUPLICATE | id | TestSuite:Create |
TEST_SUITE | DELETE | id | TestSuite:Delete |
TEST_FOLDER | CREATE | complete new folder path; testFolderType | Create permission of the folder type |
TEST_FOLDER | RENAME | id, new name | Update permission of the folder type |
TEST_FOLDER | MOVE | id, complete destination path, including the folder name | Update permission of the folder type |
TEST_FOLDER | DUPLICATE | id | Create permission of the folder type |
TEST_FOLDER | DELETE | id | Delete permission of the folder type |
New cases default to status PUBLISHED and priority MEDIUM. New
manual cases default to automation status TO_BE_ASSESSED. Case
UPDATE changes only the fields you send; omitted manual content stays.
Suite UPDATE replaces the membership with testSuiteItems. Send the
complete list, or [] to remove all members. It does not rename the
suite. To add members without replacing the list, use ADD_TEST_CASES.
testCaseIds is the older, version-unaware alternative.
To set custom-field values, send data.customizableFields on a case
UPDATE after you create the case. CREATE does not save them. Use the
Admin definition ID and option UUID, not a numeric option ID. The
definitions must first be replicated from Admin. An empty outer list
changes nothing; values: [] clears that field. Custom-field values you
set here are not returned by Get a test case. Read them with
List custom-field values. See the
custom-field guide.
DELETE can affect linked assets. A deleted suite can remain available
as historical execution data. Folder rename, move, and delete affect
descendants. Suite-folder changes other than creation need an eligible
Cloud repository and the feature enabled for your organization. You
cannot change the root Test Suites folder.
With async=false, the response returns each created asset's ID in
testEntities[].data.id. With async=true, the response can contain a
task (taskResource) instead of completed changes. A 200 response does
not mean repository files have finished publishing.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Authentication is missing or invalid.
The caller lacks access or the required permission.
The requested asset was not found. Some inaccessible or deleted assets can instead return 400 or 403.
The request could not be completed. Inspect the response before retrying a mutation.