Logs
Logs API methods, requests, and responses for RawTree Cloud and RawTree BYOC.
Logs
Log reads require read permission. Select a bounded time range with start_time and end_time.
GET /v1/logs
List platform API requests captured by the service's internal request spans. Query execution history belongs to the Queries screen; this endpoint focuses on HTTP request activity.
Query parameters:
| Parameter | Description |
|---|---|
start_time | Inclusive lower bound. |
end_time | Inclusive upper bound. |
limit | Rows to return. Default 50, max 200. |
offset | Rows to skip. |
search | Free-text search across log ID, method, path, status, source, user agent, and errors. |
methods | Comma-separated HTTP methods, such as GET,POST. |
status_codes | Comma-separated HTTP status codes, such as 200,404,500. |
sources | Comma-separated request sources: ui, cli, or api. |
user_agent | Exact user-agent value. |
Each log includes its span-based log ID, creation time, method, URL path, matched API route, status code, source, duration, user agent, client version, request size, trace ID, database, and structured error details when the request failed. A bounded textual request body may be included for supported requests (up to 8 KiB); response body content is not recorded.
Use an API key, a permitted workload token, or a user bearer token. Database-role keys support only the operations listed in Authentication.
Parameters:
| Field | Location | Type | Required | Notes |
|---|---|---|---|---|
search | query | string | No | Free-text search across log ID, method, path, status, source, user agent, and errors. |
methods | query | string | No | Comma-separated HTTP methods, for example GET,POST. |
status_codes | query | string | No | Comma-separated HTTP status codes, for example 200,404,500. |
levels | query | string | No | Comma-separated request levels: success, warning, or error. |
sources | query | string | No | Comma-separated request sources: ui, cli, or api. |
user_agent | query | string | No | Exact user-agent value. |
host | query | string | No | Case-insensitive substring of the request host. |
paths | query | string | No | Comma-separated exact request paths. |
min_duration_ms | query | integer | No | Minimum request duration in milliseconds. |
max_duration_ms | query | integer | No | Maximum request duration in milliseconds. |
start_time | query | string | No | Inclusive lower bound using a RawTree-compatible datetime string. |
end_time | query | string | No | Inclusive upper bound using a RawTree-compatible datetime string. |
limit | query | integer | No | Number of rows to return (default 50, max 200). |
offset | query | integer | No | Number of rows to skip (default 0). |
Request:
# List platform API request logs.
curl -X GET "https://api.rawtree.com/v1/logs?database=analytics&start_time=2026-11-09T09%3A00%3A00Z&end_time=2026-11-09T10%3A00%3A00Z" \
-H "Authorization: Bearer $RAWTREE_API_KEY"Expected response: HTTP 200.
{
"logs": [],
"has_more": false,
"next_offset": null
}Errors: 400, 401. See API errors.