FAfal
Serverless
Logs

Logs stream (SSE)

Changed on

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

Required permissions: serverless:logs:read. Key presets that include them: SERVERLESS, DEPLOY, READONLY, FULL. See key permissions.

post/serverless/logs/stream

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/serverless/logs/stream
  • Auth
    API key in header Authorization

Query parameters

string date-time
OR
string
string date-time
OR
string
string
OR
string[]
revisionstring

Filter by revision

Example:rev_abc123
run_source'grpc-run' | 'grpc-register' | 'gateway' | 'cron'

Filter by run source

Example:grpc-run
tracebackboolean nullable

Include tracebacks

searchstring

Free-text search

Example:error
levelstring

Minimum log level

Example:error
job_idstring

Filter by job id

Example:job_123
request_idstring

Filter by request id

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

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

  • 479db2f9dcd6Revision changes
    • info

      the endpoint scheme security readonlyApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API