Issues API | Product Documentation

Issues represent problems or anomalies detected during run sessions. The platform can automatically analyze issues using LLM-powered pipelines and provide JIT (Just-In-Time) summaries with next-step recommendations.

List Issues

Retrieve all issues in a workspace.


Method	`GET`
Path	`/api/v3/workspaces/{workspace_name}/issues/`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number for pagination

Response 200 OK

JSON

{
  "count": 8,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 42,
      "slxName": "check-pod-health",
      "title": "CrashLoopBackOff detected in namespace monitoring",
      "severity": "high",
      "state": "open",
      "createdAt": "2026-02-28T14:00:00Z",
      "updatedAt": "2026-02-28T14:05:00Z"
    }
  ]
}

Get Issue Detail

Retrieve full details of a specific issue.


Method	`GET`
Path	`/api/v3/workspaces/{workspace_name}/issues/{issue_id}`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace
`issue_id`	integer	The ID of the issue

Response 200 OK

Returns the complete issue object with all associated metadata.

Update Issue

Update the state or metadata of an issue.


Method	`PATCH`
Path	`/api/v3/workspaces/{workspace_name}/issues/{issue_id}`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace
`issue_id`	integer	The ID of the issue

Request Body

JSON

{
  "state": "resolved"
}

Response 200 OK

Returns the updated issue object.

Get Issue JIT Summary

Request a Just-In-Time AI-generated summary and analysis for an issue. This triggers the LLM orchestration pipeline (Sobrain) to analyze the issue context and provide actionable next steps.


Method	`GET`
Path	`/api/v3/workspaces/{workspace_name}/issues/{issue_id}/jit-summary/`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace
`issue_id`	integer	The ID of the issue

Response 200 OK

Returns an AI-generated summary including root cause analysis and recommended next steps.

List Issue Occurrences

Retrieve occurrences of a specific issue (repeated detections over time).


Method	`GET`
Path	`/api/v3/workspaces/{workspace_name}/issues/{issue_id}/occurrences/`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace
`issue_id`	integer	The ID of the issue

Response 200 OK

Returns a list of occurrence records for this issue, each with its own timestamp and context.

Get Issue Occurrence Detail

Retrieve details of a specific issue occurrence.


Method	`GET`
Path	`/api/v3/workspaces/{workspace_name}/issues/{issue_id}/occurrences/{occurrence_id}`
Auth	Bearer token required

Path Parameters

Parameter	Type	Description
`workspace_name`	string	The unique name of the workspace
`issue_id`	integer	The ID of the issue
`occurrence_id`	integer	The ID of the occurrence

Response 200 OK

Returns the full occurrence detail.