Get line run failure diagnostics

GET

https://api.islo.dev/factory/line-runs/:run_id/debug

GET

/factory/line-runs/:run_id/debug

$ curl https://api.islo.dev/factory/line-runs/run_id/debug \
>      -H "Authorization: Bearer <api_key>"

1 {
2   "id": "string",
3   "line_name": "string",
4   "status": "string",
5   "triggered_by": "string",
6   "line_version_id": "string",
7   "region": "string",
8   "started_at": "2024-01-15T09:30:00Z",
9   "completed_at": "2024-01-15T09:30:00Z",
10   "error_message": "string",
11   "failure_summary": {
12     "stage_name": "string",
13     "step_name": "string",
14     "failure_class": "string",
15     "error_code": "string",
16     "error_message": "string",
17     "error_details": {},
18     "compute_command_id": "string"
19   },
20   "stages": [
21     {
22       "stage_name": "string",
23       "stage_order": 1,
24       "iteration": 1,
25       "status": "string",
26       "outcome": "string",
27       "reason": "string",
28       "job_run_id": "string",
29       "job_version_id": "string",
30       "steps": [
31         {
32           "name": "string",
33           "action": "string",
34           "status": "string",
35           "task_name": "string",
36           "exit_code": 1,
37           "error_code": "string",
38           "failure_class": "string",
39           "error_message": "string",
40           "error_details": {},
41           "compute_command_id": "string",
42           "sandbox_name": "string",
43           "agent_session_id": "string",
44           "stdout_tail": "string",
45           "stderr_tail": "string",
46           "started_at": "2024-01-15T09:30:00Z",
47           "completed_at": "2024-01-15T09:30:00Z"
48         }
49       ],
50       "environment": {
51         "sandbox_name": "string",
52         "region": "string",
53         "snapshot_name": "string",
54         "gateway_profile": "string"
55       }
56     }
57   ]
58 }

Per-stage and per-step diagnostics for one line run, including the last failed stage attempt’s first failing step, each step’s exit code and output tails, and the sandbox environment each stage ran in.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

run_idstringRequiredformat: "uuid"

Response

Successful Response

idstringformat: "uuid"

line_namestring

statusstring

triggered_bystring

line_version_idstring or nullOptionalformat: "uuid"

regionstring or nullOptional

started_atdatetime or nullOptional

completed_atdatetime or nullOptional

error_messagestring or nullOptional

failure_summaryobject or nullOptional

The first failed step within the run's last failed stage attempt.

stageslist of objectsOptional

Errors

404

Not Found Error

422

Unprocessable Entity Error