Get aggregated log stats

GET

/v1/logs/stats

GET

/v1/logs/stats

$ curl https://api.runtype.com/v1/logs/stats \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "data": {
3     "byCategory": {
4       "authentication": 120,
5       "database": 75,
6       "api": 200,
7       "ui": 50
8     },
9     "byLevel": {
10       "debug": 180,
11       "info": 250,
12       "warn": 80,
13       "error": 35
14     },
15     "byStatus": {
16       "success": 400,
17       "failure": 145
18     },
19     "byType": {
20       "system": 300,
21       "application": 245
22     },
23     "histogram": [
24       {
25         "bucket": "2024-04-20T10:00:00Z",
26         "count": 50,
27         "errors": 5
28       },
29       {
30         "bucket": "2024-04-20T11:00:00Z",
31         "count": 70,
32         "errors": 8
33       },
34       {
35         "bucket": "2024-04-20T12:00:00Z",
36         "count": 90,
37         "errors": 12
38       }
39     ],
40     "total": 645
41   },
42   "success": true,
43   "cachedAt": null
44 }

Returns aggregated log statistics including histogram, counts by level, and counts by category.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

fromstringOptional

Start timestamp (ISO 8601)

tostringOptional

End timestamp (ISO 8601)

levelstringOptional

Comma-separated log levels (debug,info,warn,error)

categorystringOptional

Comma-separated categories

flowIdstringOptional

Filter by flow ID

agentIdstringOptional

Filter by agent ID

executionIdstringOptional

Filter by execution ID

surfaceIdstringOptional

Filter by surface ID

conversationIdstringOptional

Filter by conversation ID

searchstringOptional

Full-text search in message

limitstringOptional

Max results per page (default 500, max 1000)

cursorstringOptional

Pagination cursor

orderstringOptional

Sort order: asc or desc

Response

Log stats returned

dataobject

successboolean

cachedAtstring or null

When the response was served from cache, the cache write time. Null for fresh responses.

Errors

401

Unauthorized Error

500

Internal Server Error