Docs

Get an insight

GET /api/v1/programmatic/insights/{id}

GET/api/v1/programmatic/insights/{id}
Insightsv1insights:read

Returns one generated insight from the PAT workspace.

Parameters

NameInType Description
idpathstringRequired Stable logical insight key returned by the insights collection. This is not necessarily a UUID. anomaly_018f8e30-66fd-7e50-a1ef-9c52d11c2baf

Code examples

curl --request GET \
  --url 'https://api.tetri.app/api/v1/programmatic/insights/<id>' \
  --header 'Authorization: Bearer $TETRI_API_TOKEN'

Responses

200The requested generated insight.
{
  "data": {
    "id": "anomaly_018f8e30-66fd-7e50-a1ef-9c52d11c2baf",
    "type": "anomaly",
    "priority": "high",
    "triggered_at": "2026-07-15T06:03:00.000Z",
    "entity_id": "<uuid>",
    "associated_transaction_id": "<uuid>",
    "payload": {}
  }
}
400Request parameters or payload failed validation. Inspect `code` and `message`.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
401The personal access token is missing, invalid, expired, or revoked.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
403The token lacks the required scope or no longer has workspace access.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
404The resource does not exist in the token workspace or is not visible to this API.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}
429The credential exceeded its request rate limit.
{
  "statusCode": 400,
  "code": "PROGRAMMATIC_PAGINATION_MODE_CONFLICT",
  "message": "<string>",
  "error": "Bad Request",
  "request_id": "8cf64dcc-0f73-4f8d-a845-3d80c1040475"
}