# polymorfa logs

> Read and follow a project's API request log.

## Commands

- [polymorfa logs list](https://docs.polymorfa.com/cli/logs/list): List a project's API requests from the last 30 days, newest first. Requires logs:read.
- [polymorfa logs tail](https://docs.polymorfa.com/cli/logs/tail): Print a project's API requests as they happen. Polls the request log and requires logs:read.

## polymorfa logs list

List a project's API requests from the last 30 days, newest first. Requires logs:read.

### Usage

```bash
polymorfa logs list [flags]
```

### Flags

- `--credential <value>` (value). Only requests made by this team key or project token ID.
- `--cursor <value>` (value). Continue from page.nextCursor of an earlier page; keeps its filters.
- `--limit <value>` (value). Requests per page (default 25).
- `--method <value>` (value, repeatable). Only these HTTP methods, for example POST or GET,DELETE.
- `--request-id <value>` (value). Only the request with this X-Request-Id.
- `--route <value>` (value). Only this exact route pattern, for example /messaging/:session/messages.
- `--since <value>` (value). Earliest request time (RFC 3339).
- `--source <value>` (value). Only direct API requests or requests made through MCP. Values: `api`, `mcp`.
- `--status <value>` (value, repeatable). Only these status codes or classes, for example 404 or 4xx,5xx.
- `--trace-id <value>` (value). Only requests with this W3C trace ID (X-Trace-Id).
- `--until <value>` (value). Latest request time (RFC 3339).

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

### Examples

```bash
polymorfa logs list --project 11111111-1111-4111-8111-111111111111 --status 4xx,5xx
```

```bash
polymorfa logs list --project 11111111-1111-4111-8111-111111111111 --trace-id 4bf92f3577b34da6a3ce929d0e0e4736 --json
```

## polymorfa logs tail

Print a project's API requests as they happen. Polls the request log and requires logs:read.

### Usage

```bash
polymorfa logs tail [flags]
```

### Flags

- `--backfill <value>` (value). Print this many recent requests before following. Default: `10`.
- `--credential <value>` (value). Only requests made by this team key or project token ID.
- `--max-events <value>` (value). Stop after printing this many requests.
- `--method <value>` (value, repeatable). Only these HTTP methods, for example POST or GET,DELETE.
- `--poll-interval <value>` (value). Seconds between polls while no new requests arrive. Default: `2`.
- `--request-id <value>` (value). Only the request with this X-Request-Id.
- `--route <value>` (value). Only this exact route pattern, for example /messaging/:session/messages.
- `--source <value>` (value). Only direct API requests or requests made through MCP. Values: `api`, `mcp`.
- `--status <value>` (value, repeatable). Only these status codes or classes, for example 404 or 4xx,5xx.
- `--trace-id <value>` (value). Only requests with this W3C trace ID (X-Trace-Id).

Also accepts the [global flags](https://docs.polymorfa.com/cli#global-flags).

### Examples

```bash
polymorfa logs tail --project 11111111-1111-4111-8111-111111111111
```

```bash
polymorfa logs tail --project 11111111-1111-4111-8111-111111111111 --status 4xx,5xx --method POST
```

```bash
polymorfa logs tail --project 11111111-1111-4111-8111-111111111111 --poll-interval 5 --json
```
