> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# logs

# `prefect.server.api.logs`

Routes for interacting with log objects.

## Functions

### `create_logs` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L26](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L26)</sup>

```python theme={null}
create_logs(logs: Sequence[LogCreate], db: PrefectDBInterface = Depends(provide_database_interface)) -> None
```

Create new logs from the provided schema.

For more information, see [https://www.prefect.io/docs/v3/how-to-guides/workflows/add-logging](https://www.prefect.io/docs/v3/how-to-guides/workflows/add-logging).

### `read_logs` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L44](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L44)</sup>

```python theme={null}
read_logs(limit: int = dependencies.LimitBody(), offset: int = Body(0, ge=0), logs: Optional[LogFilter] = None, sort: LogSort = Body(LogSort.TIMESTAMP_ASC), db: PrefectDBInterface = Depends(provide_database_interface)) -> Sequence[Log]
```

Query for logs.

### `stream_logs_out` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L63](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/logs.py#L63)</sup>

```python theme={null}
stream_logs_out(websocket: WebSocket) -> None
```

Serve a WebSocket to stream live logs