...
This resource supports the following methods: DELETE, GET, PUT
Methods
DELETE
...
Deletes an execution package by its unique identifier.
...
| Status | Description |
|---|---|
| 200 - OK | Returned if execution package was deleted successfully. |
| 403 - Forbidden | Returned if execution package can not be deleted (normally because required permission have not been met or the package has children but you did not pass the deleteChildren parameter.). |
| 404 - NotFound | Returned if execution package was not found. |
Example - Delete empty package
Example of deleting a package.
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of package to delete. |
Status Code
200 - OK
Example - Delete package with children
Example of deleting a package with children.
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of package to delete. |
| deleteChildren | true | Will delete a package and all its children. |
Status Code
200 - OK
Example - Delete package with children (without deleteChildren parameter)
Example of deleting a non-empty package without deleteChildren=true.
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of package to delete. |
Response Body
| Code Block | ||
|---|---|---|
| ||
{
"Message": "The package is not empty."
}
|
Status Code
403 - Forbidden
GET
...
Retrieves an execution package by its unique identifier.
...
- TestManagement/ManageExecutions/View
Supported Expansions
...
For more details on expansions, please see the Expand help topic.
...
| Status | Description |
|---|---|
| 200 - OK | Returned if the request was completed successfully. |
| 404 - NotFound | Returned if execution package was not found. |
...
Example - GET
Example of retrieving execution package by unique identifier.
Request Headers
| Key | Value | Description | |
|---|---|---|---|
| Accept | application/json |
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of package to retrieve. |
Response Headers
| Key | Value | Description | |
|---|---|---|---|
| Content-Type | application/json; charset=utf-8 |
Response Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"ParentId": "cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Name": "New Package Name",
"Stereotype": null,
"OrderNumber": 1,
"Expands": [
"Children",
"Parent",
"Project"
],
"Self": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Links": [
{
"Href": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610/children",
"Rel": "Children"
},
{
"Href": "http://localhost/api/executionpackage/cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Rel": "Parent"
}
]
}
|
Status Code
200 - OK
...
PUT
...
Update an execution package.
...
- TestManagement/ManageExecutions/Edit
Supported Expansions
- AutomatedTestAssignments
- Children
- Parent
- Project
- AgileRunsAutomatedTestAssignments
- ScriptAssignments
- AgileRuns
For more details on expansions, please see the Expand help topic.
...
| Status | Description |
|---|---|
| 200 - OK | Returned if the request was completed successfully. |
| 403 - Forbidden | Returned if the user does not have permission to create execution packages in the target project. |
| 404 - NotFound | Returned if the package does not exist. |
Example - PUT (update package name)
Updating a package name.
Request Headers
| Key | Value | Description | |
|---|---|---|---|
| Accept | application/json |
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of relevant package to delete. |
Request Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Name": "New Package Name"
}
|
Response Headers
| Key | Value | Description | |
|---|---|---|---|
| Content-Type | application/json; charset=utf-8 |
Response Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"ProjectId": "944aa658-8067-42cf-a6a6-ce71535a73bc",
"Name": "New Package Name",
"Stereotype": null,
"OrderNumber": 1,
"Expands": [
"Children",
"Parent",
"Project"
],
"Self": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Links": [
{
"Href": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610/children",
"Rel": "Children"
},
{
"Href": "http://localhost/api/project/944aa658-8067-42cf-a6a6-ce71535a73bc",
"Rel": "Project"
}
]
}
|
Status Code
200 - OK
Example - PUT (move package to new parent)
Updating package to have a different parent.
Request Headers
| Key | Value | Description | |
|---|---|---|---|
| Accept | application/json |
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of relevant package to delete. |
Request Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"ParentId": "cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6"
}
|
Response Headers
| Key | Value | Description | |
|---|---|---|---|
| Content-Type | application/json; charset=utf-8 |
Response Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"ParentId": "cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Name": "New Package Name",
"Stereotype": null,
"OrderNumber": 1,
"Expands": [
"Children",
"Parent",
"Project"
],
"Self": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Links": [
{
"Href": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610/children",
"Rel": "Children"
},
{
"Href": "http://localhost/api/executionpackage/cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Rel": "Parent"
}
]
}
|
Status Code
200 - OK
Example - PUT (update multiple details)
Updating package name, stereotype, order and parent.
Request Headers
| Key | Value | Description | |
|---|---|---|---|
| Accept | application/json |
Request Parameters
| Key | Value | Description |
|---|---|---|
| {id} | 4bb709c2-e0e7-4af3-9f60-a045016a9610 | GUID Identifier of relevant the package to delete. |
Request Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Name": "New Package Name",
"Stereotype": "Plan",
"OrderNumber": 2,
"ParentId": "cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6"
}
|
Response Headers
| Key | Value | Description | |
|---|---|---|---|
| Content-Type | application/json; charset=utf-8 |
Response Body
| Code Block | ||
|---|---|---|
| ||
{
"Id": "4bb709c2-e0e7-4af3-9f60-a045016a9610",
"ParentId": "cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Name": "New Package Name",
"Stereotype": "Plan",
"OrderNumber": 2,
"Expands": [
"Children",
"Parent",
"Project"
],
"Self": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610",
"Links": [
{
"Href": "http://localhost/api/executionpackage/4bb709c2-e0e7-4af3-9f60-a045016a9610/children",
"Rel": "Children"
},
{
"Href": "http://localhost/api/executionpackage/cc91ec0b-a9f2-44fe-bf86-97ecb98cecc6",
"Rel": "Parent"
}
]
}
|
Status Code
200 - OK
...