Skip to main content
Opik Documentation

Search documentation

Type to search this documentation.

Store agent insights report results

POST/v1/private/agent-insights/issuesStore agent insights report results

Upserts the detected issues and their per-day metrics for the given report day in a single transaction. Issue status is never modified by this endpoint.

Request body

application/json
objectAgentInsightsReport
issuesarray of objectrequired
Show child attributes
Show array items
causestring
countinteger · int64required
descriptionstring
idstring · uuid
metadataobject
namestringrequired

maxLength 255 · minLength 0

severitystringrequired

one of "critical", "high", "medium", "low"

suggested_fixstring
total_countinteger · int64required
total_usersinteger · int64required
traces_querystring
users_impactedinteger · int64required
project_idstring · uuidrequired
report_daystring · daterequired
Example request
{
  "issues": [
    {
      "cause": "string",
      "count": 0,
      "description": "string",
      "id": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "name": "string",
      "severity": "critical",
      "suggested_fix": "string",
      "total_count": 0,
      "total_users": 0,
      "traces_query": "string",
      "users_impacted": 0
    }
  ],
  "project_id": "00000000-0000-0000-0000-000000000000",
  "report_day": "2026-06-09"
}

Responses

204Report stored
400Bad Requestapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
401Unauthorizedapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
404Project not foundapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
Documentation menu