Logs stream (SSE)

Streams live logs that match the provided filters using Server-Sent Events.

post/serverless/logs/stream

Query parameters

string date-time

string

Start date in ISO8601 format (e.g., '2025-01-01T00:00:00Z' or '2025-01-01'). Defaults to 24 hours ago.

string date-time

string

End date in ISO8601 format, exclusive (e.g., '2025-02-01T00:00:00Z' or '2025-02-01'). Data up to but not including this timestamp is returned. Defaults to current time.

string

string[]

Filter by specific app ID(s) in '<owner>/<name>' format (e.g. 'fal-ai/my-app'). Accepts 1-50 app IDs. Supports comma-separated values: ?app_id=fal-ai/foo,fal-ai/bar or array syntax: ?app_id=fal-ai/foo&app_id=fal-ai/bar

revisionstring

Filter by revision

Example:rev_abc123

Filter by revision

run_source'grpc-run' | 'grpc-register' | 'gateway' | 'cron'

Filter by run source

Example:grpc-run

Filter by run source

tracebackboolean nullable

Include tracebacks

searchstring

Free-text search

Example:error

Free-text search

levelstring

Minimum log level

Example:error

Minimum log level

job_idstring

Filter by job id

Example:job_123

Filter by job id

request_idstring

Filter by request id

Example:019e6d0a-e5be-7b82-b329-35ae64296902

Filter by request id

Request body

keystring required

Label key to filter

condition_type'equals' | 'in' | 'not_equals' | 'not_in'

Condition type for label filtering

Response

SSE stream started

Changes

No recorded changes to this endpoint across all 2 revisions of this API.