> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://www.comet.com/docs/opik/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://www.comet.com/docs/opik/_mcp/server. # Find agent insights issues GET http://localhost:5173/api/v1/private/agent-insights/issues Returns a paginated list of issues that have at least one detail row within the requested time window, with metrics aggregated over the window Reference: https://www.comet.com/docs/opik/reference/rest-api/agent-insights/find-agent-insights-issues ## Servers - `http://localhost:5173/api` (Local server, default) - `https://www.comet.com/opik/api` (Opik Cloud) ## Request ### Query parameters - `project_id` (string, required) - `from_date` (date, optional) - `to_date` (date, optional) - `status` (enum, optional) - Allowed values: `open`, `resolved`, `closed` - `severity` (enum, optional) - Allowed values: `critical`, `high`, `medium`, `low` - `sorting` (string, optional) - `page` (integer, optional, default: 1) - `size` (integer, optional, default: 10) ## Response ### 200 Issues page - `page` (integer, optional) - `size` (integer, optional) - `total` (long, optional) - `content` (list of object, optional) - `id` (string, optional) - `name` (string, optional) - `description` (string, optional) - `cause` (string, optional) - `suggested_fix` (string, optional) - `status` (enum, optional) - Allowed values: `open`, `resolved`, `closed` - `severity` (enum, optional) - Allowed values: `critical`, `high`, `medium`, `low` - `traces_query` (string, optional) - `total_occurrences` (long, optional) — SUM(count) over the requested window - `latest_count` (long, optional) — Occurrences on the latest report day in the window only. The issue's description/cause narrate that most recent run, so this is the count consistent with them; totalOccurrences instead sums every day in the window. - `total` (long, optional) — SUM(total_count) over the requested window - `users_impacted` (long, optional) — SUM(users_impacted) over the requested window - `total_users` (long, optional) — SUM(total_users) over the requested window - `first_seen` (date, optional) — MIN(report_day) in the requested window - `last_seen` (date, optional) — MAX(report_day) in the requested window - `days_reported` (long, optional) — COUNT(DISTINCT report_day) in the requested window - `created_by` (string, optional) - `created_at` (datetime, optional) - `last_updated_by` (string, optional) - `last_updated_at` (datetime, optional) ## Errors ### 400 Bad Request Error Bad Request - `code` (integer, optional) - `message` (string, optional) - `details` (string, optional) ### 401 Unauthorized Error Unauthorized - `code` (integer, optional) - `message` (string, optional) - `details` (string, optional) ## Examples **Request** ```json {} ``` **Response** ```json { "page": 1, "size": 1, "total": 1, "content": [ { "id": "d290f1ee-6c54-4b01-90e6-d701748f0851", "name": "Database Connection Timeout", "description": "Frequent timeouts when connecting to the primary database cluster.", "cause": "Network latency spikes causing connection drops.", "suggested_fix": "Investigate network stability and optimize connection retry logic.", "status": "open", "severity": "critical", "traces_query": "SELECT * FROM logs WHERE error_type = 'DB_TIMEOUT' AND timestamp >= '2024-04-01' AND timestamp <= '2024-04-07'", "total_occurrences": 125, "latest_count": 20, "total": 125, "users_impacted": 45, "total_users": 200, "first_seen": "2024-04-01", "last_seen": "2024-04-07", "days_reported": 5, "created_by": "jane.doe@example.com", "created_at": "2024-04-01T08:15:00Z", "last_updated_by": "john.smith@example.com", "last_updated_at": "2024-04-07T16:45:00Z" } ] } ``` **SDK Code** ```python import requests url = "http://localhost:5173/api/v1/private/agent-insights/issues" querystring = {"from_date":"2024-04-01","page":"1","project_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","severity":"critical","size":"10","sorting":"severity:desc","status":"open","to_date":"2024-04-07"} payload = {} headers = {"Content-Type": "application/json"} response = requests.get(url, json=payload, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07'; const options = {method: 'GET', headers: {'Content-Type': 'application/json'}, body: '{}'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07" payload := strings.NewReader("{}") req, _ := http.NewRequest("GET", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07") http = Net::HTTP.new(url.host, url.port) request = Net::HTTP::Get.new(url) request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('GET', 'http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07', [ 'body' => '{}', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07"); var request = new RestRequest(Method.GET); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "http://localhost:5173/api/v1/private/agent-insights/issues?from_date=2024-04-01&page=1&project_id=3fa85f64-5717-4562-b3fc-2c963f66afa6&severity=critical&size=10&sorting=severity%3Adesc&status=open&to_date=2024-04-07")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```