List logs
render_list_logsFetch filtered logs from Render resources by time, resource, type, and other criteria. Use start and end timestamps to paginate through complete log history.
Instructions
List logs. List logs matching the provided filters. Logs are paginated by start and end timestamps. There are more logs to fetch if hasMore is true in the response. Provide the nextStartTime and nextEndTime timestamps as the startTime and endTime query parameters to fetch the next page of logs. You can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner. Calls GET /logs on the Render Public API. Usage: Requires an ownerId and a resource array of ids. For the common case — recent logs for one service — render_recent_logs takes a service name and fills both in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Filter request logs by their host. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| path | No | Filter request logs by their path. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| task | No | Filter logs by their task(s) | |
| text | No | Filter by the text of the logs. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| type | No | Filter logs by their type. Types include `app` for application logs, `request` for request logs, and `build` for build logs. You can find the full set of types available for a query by using the `GET /logs/values` endpoint. | |
| level | No | Filter logs by their severity level. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| limit | No | The maximum number of items to return. For details, see [Pagination](https://api-docs.render.com/reference/pagination). | |
| method | No | Filter request logs by their requests method. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| endTime | No | Epoch/Unix timestamp of end of time range to return. Defaults to `now()`. | |
| ownerId | Yes | The ID of the workspace to return logs for | |
| sandbox | No | Filter logs by sandbox ID. | |
| taskRun | No | Filter logs by their task run id(s) | |
| instance | No | Filter logs by the instance they were emitted from. An instance is the id of a specific running server. | |
| resource | Yes | Filter logs by their resource. A resource is the id of a server, cronjob, job, postgres, redis, workflow, or sandbox group. | |
| direction | No | The direction to query logs for. Backward will return most recent logs first. Forward will start with the oldest logs in the time range. | backward |
| startTime | No | Epoch/Unix timestamp of start of time range to return. Defaults to `now() - 1 hour`. | |
| statusCode | No | Filter request logs by their status code. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. |