Log Sources

Create a log source

Create a log source. Managed mode takes vendor credentials in metadata, validates them, and provisions delivery behind the log source. Connectionless mode mints the log source plus a keyed log stream and returns the intake key and endpoint card(s) to point the sender at.

post/log-sources

Request body

projectIdstring uuid

Project to create the log source in. Auto-filled from SDK context when omitted.

provider'vercel' | 'cloudflare' | 'railway' | 'render' | 'fly_io' | 'netlify' | 'supabase' | 'digital_ocean' | 'inngest' | 'trigger_dev' | 'temporal' | 'mastra' | 'neon' | 'langchain' | 'daytona' | 'e2b' | 'cloudwatch' | 'convex' | 'datadog' | 'sentry' | 'sentry_platform' | 'openrouter' | 'posthog' | 'posthog_sdk' | 'gcp' | 'otel' | 'otel_metrics' | 'fluent_bit' | 'vector' | 'grafana_alloy' | 'otel_collector' | 'cloudflare_workers' | 'elastic_cloud' | 'porter' | 'respan' | 'plain' | 'prometheus' | 'webhook_events' | 'claude_code' | 'codex' | 'sazabi_browser_sdk' required

Log source provider identifier.

mode'managed' | 'connectionless'

Setup mode. Defaults to managed when metadata is provided, otherwise connectionless. Must be a mode the provider supports (see modes on the provider catalog).

metadataobject

Vendor credentials and configuration for managed setup. Fields vary by provider (see metadataFields on the provider catalog). Required for managed mode; must be omitted for connectionless mode.

Response

OK

streamIdstring uuid

ID of the log stream created alongside the log source. Present for connectionless log sources (which always mint their keyed log stream) and for managed providers that auto-provision a default log stream.

publicKeystring

Intake key minted for the log source. Store this securely — it is only shown once. Present for connectionless log sources and for managed providers that ingest through a Sazabi endpoint.

Changes

Changed in 1 of the 4 revisions of this API.1

    • added the required property / to the response with the status

      response-required-property-added