Link artifacts (generic)
qtest_link_artifactsLink any two qTest artifact types—test cases, requirements, defects, or test runs—by specifying source and target IDs. Supports creating or removing links.
Instructions
Generic object-linking between any two qTest artifact types. Link the source object (objectType/objectId) to the given target IDs of linkType. Example: link a 'test-cases' object to 'defects'. Supported types: test-cases, requirements, defects, test-runs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"objectType": "<objectType>",
"objectId": "<objectId>",
"linkType": "<linkType>",
"targetIds": "<targetIds>"
},
"name": "qtest_link_artifacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unlink | No | If true, remove the links instead of creating them. | |
| linkType | Yes | Target artifact type to link to. | |
| objectId | Yes | Source artifact ID. | |
| projectId | Yes | Numeric project ID. | |
| targetIds | Yes | Target artifact IDs to link. | |
| objectType | Yes | Source artifact type (plural, hyphenated). |