Date: Fri, 29 Mar 2024 14:20:31 +0000 (UTC) Message-ID: <134004394.12433.1711722031870@catch-kbase-p> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_12432_863267250.1711722031868" ------=_Part_12432_863267250.1711722031868 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Agile Run Step Incidents (collection) resource - used to retrieve a coll= ection of all incidents linked to an agile run step, or to link a new incid= ent to a step.
This resource supports the following methods: GET, POST=
Retrieves list of incidents linked to the agile run step.
This method supports the OData parameters $filter, $top, $take, $orderby= and $inlinecount. See = OData Topic for more details.
These are the expected status codes returned by the service. In addition= , some other status codes may be returned if either an internal error occur= s or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
200 - OK | Returned if the request was completed successful= ly. |
403 - Forbidden | Returned if you do not have permission to view t= he list of incidents associated with this agile run step. |
404 - NotFound | Returned if agile run, step or incident does not= exist. |
Retrieves all incidents linked to a agile run step.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{runId} | b716ac5e-61a3-4394-9b50-a13014129864 | The unique identifier (GUID) of the agile run.= td> |
{stepId} | cbd88178-5e33-43b4-8172-01beaf5bdb75 | The unique identifier (GUID) of the agile run st= ep. |
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=3Dutf-8 |
Response Body
{ "Items": [ { "StepId": "cbd88178-5e33-43b4-8172-01beaf5bdb75", "RunId": "b716ac5e-61a3-4394-9b50-a13014129864", "IncidentId": "0f61b42d-87f9-40b8-89ee-1bc12a6b5dba", "Expands": [ "Incident", "Run" ], "Self": "http://localhost/api/agilerun/b716ac5e-61a3-4394-9b50-a13014= 129864/step/cbd88178-5e33-43b4-8172-01beaf5bdb75/incident/0f61b42d-87f9-40b= 8-89ee-1bc12a6b5dba", "Links": [ { "Href": "http://localhost/api/incident/0f61b42d-87f9-40b8-89ee-1b= c12a6b5dba", "Rel": "Incident" } ] }, { "StepId": "cbd88178-5e33-43b4-8172-01beaf5bdb75", "RunId": "b716ac5e-61a3-4394-9b50-a13014129864", "IncidentId": "24dfb384-2026-487d-b04b-2de429933508", "Expands": [ "Incident", "Run" ], "Self": "http://localhost/api/agilerun/b716ac5e-61a3-4394-9b50-a13014= 129864/step/cbd88178-5e33-43b4-8172-01beaf5bdb75/incident/24dfb384-2026-487= d-b04b-2de429933508", "Links": [ { "Href": "http://localhost/api/incident/24dfb384-2026-487d-b04b-2d= e429933508", "Rel": "Incident" } ] } ] }
Status Code
200 - OK
Create agile run step incident link.
These are the expected status codes returned by the service. In addition= , some other status codes may be returned if either an internal error occur= s or there is an authentication issue (such as an expired OAuth token).
Status | Description |
---|---|
200 - OK | Returned if the incident was already linked to t= his step. |
201 - Created | Returned if link to incident was created success= fully. |
403 - Forbidden | Returned if insufficient permission to link to t= his incident. |
404 - NotFound | Returned if agile run, step or incident does not= exist. |
Create a new incident to agile run step link.
Request Headers
Key | Value | Description |
---|---|---|
Accept | application/json |
Request Parameters
Key | Value | Description |
---|---|---|
{runId} | b716ac5e-61a3-4394-9b50-a13014129864 | The unique identifier (GUID) of the agile run.= td> |
{stepId} | cbd88178-5e33-43b4-8172-01beaf5bdb75 | The unique identifier (GUID) of the agile run st= ep. |
Request Body
{ "StepResultId": null, "IncidentId": "0f61b42d-87f9-40b8-89ee-1bc12a6b5dba" }
Response Headers
Key | Value | Description |
---|---|---|
Content-Type | application/json; charset=3Dutf-8 | |
Location | http://localhost/api/stepresult/B849F98E-6= 2B2-460C-97EF-49E6C478A3F9/incident/0F61B42D-87F9-40B8-89EE-1BC12A6B5DBA |
Response Body
{ "StepId": "cbd88178-5e33-43b4-8172-01beaf5bdb75", "RunId": "b716ac5e-61a3-4394-9b50-a13014129864", "IncidentId": "0f61b42d-87f9-40b8-89ee-1bc12a6b5dba", "Expands": [ "Incident", "Run" ], "Self": "http://localhost/api/agilerun/b716ac5e-61a3-4394-9b50-a130141298= 64/step/cbd88178-5e33-43b4-8172-01beaf5bdb75/incident/0f61b42d-87f9-40b8-89= ee-1bc12a6b5dba", "Links": [ { "Href": "http://localhost/api/incident/0f61b42d-87f9-40b8-89ee-1bc12a= 6b5dba", "Rel": "Incident" } ] }
Status Code
201 - Created