List rule logs (v2)

List logs for a particular rule with cursor-based pagination.

This endpoint handles S3-stored outcomes correctly by using run_outcomes_count to predict batch sizes and avoid over-fetching.

GET /api/v1/runs/rules/{rule_id}/logs/v2

Error

A valid request URL is required to generate request examples

200

{
  "logs": [
    {
      "rule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "run_name": "<string>",
      "run_type": "<string>",
      "run_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "run_trace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "application_time": "2023-11-07T05:31:56Z",
      "add_to_annotation_queue": {
        "payload": {}
      },
      "add_to_dataset": {
        "payload": {}
      },
      "evaluators": {
        "payload": {}
      },
      "alerts": {
        "payload": {}
      },
      "webhooks": {
        "payload": {}
      },
      "extend_only": {
        "payload": {}
      },
      "thread_id": "<string>"
    }
  ],
  "cursor": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Path Parameters

rule_id · string<uuid> · required

Query Parameters

limit · integer · default: 150

Required range: 1 <= x <= 1440

cursor · string | null

backfill · boolean · default: false

start_time · string<date-time> | null

end_time · string<date-time> | null

session_id · string<uuid> | null

Response

200

application/json

Successful Response

Paginated response for rule logs with cursor-based pagination.

logs · RuleLogSchema · object[] · required

Show child attributes

cursor · string | null