For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Discord
DocsAPI Reference
DocsAPI Reference
  • Projects
    • GETList projects
    • POSTCreate a project
    • GETGet a project
    • DELDelete a project
    • PATCHUpdate a project
    • POSTTrigger a dynamic pull request run
    • GETList project credentials
    • POSTCreate a project credential
    • GETList project memories
    • POSTCreate a project memory
    • DELDelete a project memory
    • GETList project files
    • GETList project mobile apps
    • POSTUpload a project mobile app
    • DELDelete a project mobile app
    • POSTInitiate a project mobile app upload
    • POSTConfirm a project mobile app upload
  • Tests
    • GETList tests
    • POSTCreate a test
    • GETGet a test
    • DELDelete a test
    • PATCHUpdate a test
    • POSTTrigger a test run
  • Groups
    • GETList test groups
    • POSTCreate a test group
    • GETGet a test group
    • DELDelete a test group
    • PATCHUpdate a test group
    • POSTAdd a test to a group
    • DELRemove a test from a group
    • POSTTrigger a test group run
  • Webhooks
    • POSTTrigger a project webhook
    • POSTTrigger a group webhook
  • Test Runs
    • GETList test runs
    • GETGet test run status
    • POSTCancel a queued or running run
LogoLogo
Discord
Test Runs

Get test run status

||View as Markdown|
GET
https://tester.army/api/v1/runs/:id
GET
/api/v1/runs/:id
$curl https://tester.army/api/v1/runs/id \
>     -H "Authorization: Bearer <token>"
1{
2  "id": "string",
3  "type": "ci",
4  "status": "queued",
5  "input": {},
6  "createdAt": "2024-01-15T09:30:00Z",
7  "platform": "web",
8  "source": "api",
9  "projectId": "string",
10  "output": {
11    "featureName": "string",
12    "result": "PASS",
13    "description": "string",
14    "screenshots": [
15      "string"
16    ],
17    "issues": [
18      {
19        "name": "string",
20        "description": "string",
21        "url": "string",
22        "type": "issue",
23        "severity": 1,
24        "reproductionSteps": [
25          "string"
26        ],
27        "expectedBehavior": "string",
28        "actualBehavior": "string",
29        "screenshotUrl": "string",
30        "tMs": 1
31      }
32    ],
33    "steps": [
34      {
35        "stepIndex": 1,
36        "title": "string",
37        "status": "passed",
38        "type": "act",
39        "summary": "string",
40        "error": "string",
41        "errorCode": "AUTH_CREDENTIAL_UNAVAILABLE",
42        "startedAtMs": 1,
43        "completedAtMs": 1,
44        "reusableActionTrace": {
45          "version": 1,
46          "stepKey": "string",
47          "stepTitle": "string",
48          "actions": [
49            {
50              "order": 1,
51              "toolName": "string",
52              "summary": "string",
53              "target": {
54                "kind": "role",
55                "role": "string",
56                "name": "string",
57                "nth": 1,
58                "selector": "string",
59                "element": "string"
60              },
61              "input": {
62                "url": "string",
63                "field": "username",
64                "option": "string",
65                "key": "string",
66                "direction": "up",
67                "amount": 1,
68                "focused": true,
69                "sequentially": true
70              }
71            }
72          ],
73          "confidence": "medium",
74          "stepType": "act"
75        }
76      }
77    ]
78  },
79  "testPlan": {
80    "instructions": "string",
81    "focusAreas": [
82      "string"
83    ],
84    "complexity": "simple",
85    "changeType": "frontend",
86    "steps": [
87      {
88        "title": "string",
89        "type": "act"
90      }
91    ]
92  },
93  "error": {
94    "code": "string",
95    "message": "string"
96  },
97  "durationMs": 1.1,
98  "webhookUrl": "string",
99  "webhookStatus": "pending",
100  "testId": "string",
101  "stepResults": [
102    {}
103  ],
104  "userName": "string",
105  "externalRef": {},
106  "executionMode": "fast",
107  "startedAt": "2024-01-15T09:30:00Z",
108  "completedAt": "2024-01-15T09:30:00Z"
109}
Retrieve the current status and result of a test run. Poll this endpoint to check for completion.
Was this page helpful?
Previous

List test runs

Next

Cancel a queued or running run

Built with

Authentication

AuthorizationBearer
API key authentication using Bearer token format

Path parameters

idstringRequiredformat: "uuid"
Test run ID

Response

Run details
idstringformat: "uuid"
Unique run identifier
typeenum
Run type
Allowed values:
statusenum
Current run status
Allowed values:
inputmap from strings to any
Original request input
createdAtdatetime
When the run was created
platformenum or null
Target platform
Allowed values:
sourceenum or null
Run source
projectIdstring or nullformat: "uuid"
Linked project ID
outputobject or null
Test result when completed
testPlanobject or null

Generated test plan (CI runs only)

errorobject or null
Error details when failed
durationMsdouble or null
Execution time in milliseconds
webhookUrlstring or nullformat: "uri"
Webhook delivery URL
webhookStatusenum or null
Webhook delivery status
Allowed values:
testIdstring or nullformat: "uuid"
Linked test ID
stepResultslist of maps from strings to any or null

Step-level results for structured test runs

userNamestring or null
Display name of the user who triggered the run
externalRefmap from strings to any or null

External integration metadata (e.g. GitHub PR/deployment IDs)

executionModeenum or null
Execution mode used for this run
Allowed values:
startedAtdatetime or null
When execution started
completedAtdatetime or null
When execution finished

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
504
Gateway Timeout Error