Update Test Case
update_test_caseDestructiveIdempotent
Update an existing test case in Allure TestOps with partial field updates. Replace steps, attachments, tags, issues, or custom fields while preserving omitted values. Requires confirmation to proceed.
Instructions
Update an existing test case in Allure TestOps. ⚠️ CAUTION: Destructive.
Performs a partial update: only supplied fields are sent to the API. When
provided, steps replace all existing steps, and attachments replace
all existing global attachments. Omit a field to preserve its current value.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New name for the test case | |
| tags | No | New list of tags | |
| links | No | New list of external links. Each dict has 'name', 'url', and optional 'type'. | |
| steps | No | New list of steps. Each step is a dict with 'action', 'expected', and optional 'attachments' list. | |
| issues | No | List of issue keys to ADD (e.g. ['PROJ-123']). | |
| confirm | No | Must be set to True to proceed with update. Safety measure. | |
| automated | No | Set whether the test case is automated | |
| status_id | No | ID of the test case status | |
| project_id | No | Optional override for the default Project ID. | |
| attachments | No | New list of global attachments. Each dict has 'name' and 'content' (base64) or 'url'. | |
| description | No | New description | |
| workflow_id | No | ID of the workflow | |
| clear_issues | No | If True, remove ALL issues from the test case. | |
| precondition | No | New precondition | |
| test_case_id | Yes | The ID of the test case to update | |
| custom_fields | No | Dictionary of custom fields to update (Name -> Value or list of values) | |
| output_format | No | Output format: 'json' (default) or 'plain'. | |
| remove_issues | No | List of issue keys to REMOVE. | |
| test_layer_id | No | ID of the test layer | |
| integration_id | No | Optional integration ID for issue linking (use list_integrations to find IDs). Required when multiple integrations exist and adding issues. Mutually exclusive with integration_name. | |
| expected_result | No | Global expected result for the test case | |
| test_layer_name | No | Name of the test layer | |
| integration_name | No | Optional integration name for issue linking (exact case-sensitive match). Required when multiple integrations exist and adding issues. Mutually exclusive with integration_id. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| url | No | ||
| name | No | ||
| action | No | Requested operation name. | |
| changes | No | ||
| summary | No | ||
| test_case_id | No | ||
| requires_confirmation | No |