Serverless

Logs

Logs history (paginated)

Returns paginated historical logs that match the provided filters.

post/serverless/logs/history

Query parameters

limitinteger

Number of results per page

Example:100

Number of results per page

cursorstring

Pagination cursor from previous response (timestamp-based). Use as 'until' parameter for next page.

Example:2024-11-09T00:00:00.000Z

Pagination cursor from previous response (timestamp-based). Use as 'until' parameter for next page.

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

Logs history retrieved successfully

next_cursorstring nullable required

Cursor for the next page of results, null if no more pages

has_moreboolean required

Boolean indicating if more results are available (convenience field derived from next_cursor)

Changes

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