Query customer logs | Runtype Documentation

Query persisted customer logs via R2 SQL with filtering, pagination, and search.

AuthorizationBearer

API key or Clerk session token

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

Log entries returned

dataobject

successboolean

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

500

Internal Server Error

1	{
2	"data": {
3	"entries": [
4	{
5	"timestamp": "2024-06-10T15:22:30Z",
6	"level": "warn",
7	"category": "authentication",
8	"message": "User login attempt failed due to invalid credentials",
9	"flowId": "flow_9a8b7c6d5e4f3g2h1i0j",
10	"agentId": "agent_12345abcde",
11	"executionId": "exec_67890fghij",
12	"surfaceId": "surface_xyz987",
13	"conversationId": "conv_456def789"
14	}
15	],
16	"pagination": {
17	"cursor": "eyJwYWdlIjoxLCJpZCI6IjY1NDMyMSJ9",
18	"hasMore": true
19	},
20	"degraded": true
21	},
22	"success": true
23	}

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