Langfuse JS/TS SDKs
    Preparing search index...

    Interface CreateBlobStorageIntegrationRequest

    interface CreateBlobStorageIntegrationRequest {
        accessKeyId?: string;
        bucketName: string;
        compressed?: boolean;
        enabled: boolean;
        endpoint?: string;
        exportFieldGroups?: BlobStorageExportFieldGroup[];
        exportFrequency: BlobStorageExportFrequency;
        exportMode: BlobStorageExportMode;
        exportSource?: BlobStorageExportSource;
        exportStartDate?: string;
        fileType: BlobStorageIntegrationFileType;
        forcePathStyle: boolean;
        prefix?: string;
        projectId: string;
        region: string;
        secretAccessKey?: string;
        type: BlobStorageIntegrationType;
    }
    Index

    Properties

    accessKeyId? bucketName compressed? enabled endpoint? exportFieldGroups? exportFrequency exportMode exportSource? exportStartDate? fileType forcePathStyle prefix? projectId region secretAccessKey? type

    Properties

    accessKeyId?: string

    Access key ID for authentication

    bucketName: string

    Name of the storage bucket. For AZURE_BLOB_STORAGE, must be a valid Azure container name (3-63 chars, lowercase letters, numbers, and hyphens only, must start and end with a letter or number, no consecutive hyphens).

    compressed?: boolean

    Enable gzip compression for exported files (.csv.gz, .json.gz, .jsonl.gz). Defaults to true.

    enabled: boolean

    Whether the integration is active

    endpoint?: string

    Custom endpoint URL (required for S3_COMPATIBLE type)

    exportFieldGroups?: BlobStorageExportFieldGroup[]

    Field groups to include in each exported observation row. Applies to all export sources; must include core if provided. When omitted on create, the column default (all groups) applies. When omitted on update, the existing value is preserved.

    exportFieldGroups requires exportSource to be provided in the same request.

    exportFrequency: BlobStorageExportFrequency
    exportMode: BlobStorageExportMode
    exportSource?: BlobStorageExportSource

    Data to export. When omitted on update, the existing value is preserved. When omitted on create: integrations on Langfuse Cloud default to OBSERVATIONS_V2; self-hosted deployments fall back to LEGACY_TRACES_OBSERVATIONS. Required when exportFieldGroups is provided.

    Cloud-only project deprecation gate (effective 2026-05-20): For projects created on or after 2026-05-20 on Langfuse Cloud, LEGACY_TRACES_OBSERVATIONS and LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS are rejected with HTTP 400. Use OBSERVATIONS_V2 for all new integrations. Self-hosted deployments are unaffected.

    Cloud-only integration deprecation gate (effective 2026-06-22): On Langfuse Cloud, legacy export sources are only accepted for blob storage integrations created before 2026-06-22, regardless of project age. Requests that would create a new integration with LEGACY_TRACES_OBSERVATIONS or LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS are rejected with HTTP 400. Use OBSERVATIONS_V2 instead. Self-hosted deployments are unaffected.

    exportStartDate?: string

    Custom start date for exports (required when exportMode is FROM_CUSTOM_DATE). Must not be in the future (27 h tolerance for timezone differences).

    fileType: BlobStorageIntegrationFileType
    forcePathStyle: boolean

    Use path-style URLs for S3 requests

    prefix?: string

    Path prefix for exported files (must end with forward slash if provided)

    projectId: string

    ID of the project in which to configure the blob storage integration

    region: string

    Storage region

    secretAccessKey?: string

    Secret access key for authentication (will be encrypted when stored)

    type: BlobStorageIntegrationType

    Settings

    Member Visibility

    On This Page

    Properties