CI endpointsGet run status

Get run status

Read the current state and available case results for a run in the CI token's project.

curl -X GET "https://app.aegisrunner.com/api/v1/ci/runs/123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "example_string",
  "isFinished": true,
  "exitCode": 42,
  "totalCases": 42,
  "passedCases": 42,
  "failedCases": 42,
  "skippedCases": 42,
  "duration_ms": 42,
  "createdAt": "2024-12-25T10:00:00Z",
  "completed_at": "2024-12-25T10:00:00Z",
  "cases": [
    {
      "name": "John Doe",
      "suiteName": "John Doe",
      "status": "example_string",
      "durationMs": 42,
      "errorMessage": "example_string",
      "failureType": "example_string"
    }
  ]
}
GET
/ci/runs/{runId}
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Create a project token under Project setup → CI/CD.

Create a project token under Project setup → CI/CD.
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Create a project token under Project setup → CI/CD.

Path Parameters

Responses

idstring
Required
statusstring
Required

Terminal values include completed, failed, cancelled, and needs_review.

isFinishedboolean
Required
exitCodeinteger
Required

Returns 1 for failed and 0 otherwise. Also inspect failedCases and handle cancelled.

Allowed values:01
totalCasesinteger
passedCasesinteger
failedCasesinteger
skippedCasesinteger
duration_msinteger
createdAtstring
completed_atstring
casesarray

Per-case details when the run is terminal and results are available.

Read the current state and available case results for a run in the CI token's project. Continue polling until isFinished is true, then inspect status and failedCases.

See API authentication for tokens and API errors for completion and failure handling.