Skip to content
Shortcut: /, ⌘K or Ctrl+K

polymorfa logs

Read and follow a project's API request log.

Polymorfa CLI · CLI API requests

View as Markdown

polymorfa logs list

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

Usage

polymorfa logs list [flags]

Examples

polymorfa logs list --project 11111111-1111-4111-8111-111111111111 --status 4xx,5xx
polymorfa logs list --project 11111111-1111-4111-8111-111111111111 --trace-id 4bf92f3577b34da6a3ce929d0e0e4736 --json

Flags

  • --credential <value>takes a value

    Only requests made by this team key or project token ID.

  • --cursor <value>takes a value

    Continue from page.nextCursor of an earlier page; keeps its filters.

  • --limit <value>takes a value

    Requests per page (default 25).

  • --method <value>takes a valuerepeatable

    Only these HTTP methods, for example POST or GET,DELETE.

  • --request-id <value>takes a value

    Only the request with this X-Request-Id.

  • --route <value>takes a value

    Only this exact route pattern, for example /messaging/:session/messages.

  • --since <value>takes a value

    Earliest request time (RFC 3339).

  • --source <value>takes a value

    Only direct API requests or requests made through MCP.

    Allowed valuesapimcp
  • --status <value>takes a valuerepeatable

    Only these status codes or classes, for example 404 or 4xx,5xx.

  • --trace-id <value>takes a value

    Only requests with this W3C trace ID (X-Trace-Id).

  • --until <value>takes a value

    Latest request time (RFC 3339).

Also accepts the global flags.

polymorfa logs tail

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

Usage

polymorfa logs tail [flags]

Examples

polymorfa logs tail --project 11111111-1111-4111-8111-111111111111
polymorfa logs tail --project 11111111-1111-4111-8111-111111111111 --status 4xx,5xx --method POST
polymorfa logs tail --project 11111111-1111-4111-8111-111111111111 --poll-interval 5 --json

Flags

  • --backfill <value>takes a value

    Print this many recent requests before following.

    Default 10
  • --credential <value>takes a value

    Only requests made by this team key or project token ID.

  • --max-events <value>takes a value

    Stop after printing this many requests.

  • --method <value>takes a valuerepeatable

    Only these HTTP methods, for example POST or GET,DELETE.

  • --poll-interval <value>takes a value

    Seconds between polls while no new requests arrive.

    Default 2
  • --request-id <value>takes a value

    Only the request with this X-Request-Id.

  • --route <value>takes a value

    Only this exact route pattern, for example /messaging/:session/messages.

  • --source <value>takes a value

    Only direct API requests or requests made through MCP.

    Allowed valuesapimcp
  • --status <value>takes a valuerepeatable

    Only these status codes or classes, for example 404 or 4xx,5xx.

  • --trace-id <value>takes a value

    Only requests with this W3C trace ID (X-Trace-Id).

Also accepts the global flags.