FAfal
Serverless
Logs

Logs history (paginated)

Changed on

Returns paginated historical logs that match the provided filters.

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

post/serverless/logs/history

Request

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

Query parameters

limitinteger

Number of results per page

Example:100
cursorstring

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

Example:2024-11-09T00:00:00.000Z
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

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

  • 479db2f9dcd6Revision changes
    • info

      the endpoint scheme security readonlyApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API