Implementation:Langfuse Langfuse API Blob Storage Schema

Knowledge Sources	Langfuse Langfuse API Reference
Domains	API, Integrations
Last Updated	2026-02-14 00:00 GMT

Overview

Fern API definition for the blob storage integrations API, enabling organizations to configure external S3, S3-compatible, or Azure Blob Storage connections for automated data exports.

Description

This file defines the public API contract for managing blob storage integrations under /api/public/integrations/blob-storage. These integrations allow automated export of Langfuse data to external storage buckets. The file contains three endpoints:

• GET /api/public/integrations/blob-storage -- List all blob storage integrations for the organization (requires organization-scoped API key)
• PUT /api/public/integrations/blob-storage -- Create or update a blob storage integration for a project, with validation via test upload
• DELETE /api/public/integrations/blob-storage/{id} -- Delete a blob storage integration by ID

The definition also includes several enum types for configuration options and comprehensive request/response types.

Usage

Developers reference this definition when:

• Implementing or modifying blob storage export functionality
• Building integrations that programmatically configure data exports
• Understanding the supported storage providers and export options
• Generating SDK types for storage integration management

Code Reference

Source Location

• Repository: Langfuse
• File: fern/apis/server/definition/blob-storage-integrations.yml
• Lines: 1-119

Signature

service:
  auth: true
  base-path: /api/public/integrations/blob-storage
  endpoints:
    getBlobStorageIntegrations:
      docs: Get all blob storage integrations for the organization
      method: GET
      path: ""
      response: BlobStorageIntegrationsResponse

    upsertBlobStorageIntegration:
      docs: Create or update a blob storage integration for a specific project
      method: PUT
      path: ""
      request: CreateBlobStorageIntegrationRequest
      response: BlobStorageIntegrationResponse

    deleteBlobStorageIntegration:
      docs: Delete a blob storage integration by ID
      method: DELETE
      path: "/{id}"
      response: BlobStorageIntegrationDeletionResponse

I/O Contract

Endpoints

Method	Path	Description
GET	/api/public/integrations/blob-storage	List all blob storage integrations for the organization
PUT	/api/public/integrations/blob-storage	Create or update a blob storage integration (validated via test upload)
DELETE	/api/public/integrations/blob-storage/{id}	Delete a blob storage integration

Key Types

Type Name	Description
BlobStorageIntegrationType	Enum: S3, S3_COMPATIBLE, AZURE_BLOB_STORAGE
BlobStorageIntegrationFileType	Enum: JSON, CSV, JSONL
BlobStorageExportMode	Enum: FULL_HISTORY, FROM_TODAY, FROM_CUSTOM_DATE
BlobStorageExportFrequency	Enum: hourly, daily, weekly
CreateBlobStorageIntegrationRequest	Request with projectId, storage type, bucket config, credentials, export settings
BlobStorageIntegrationResponse	Full integration record with id, config, sync timestamps
BlobStorageIntegrationsResponse	List wrapper containing BlobStorageIntegrationResponse items
BlobStorageIntegrationDeletionResponse	Deletion confirmation with message string

Usage Examples

# List blob storage integrations
curl -X GET "https://cloud.langfuse.com/api/public/integrations/blob-storage" \
  -H "Authorization: Bearer $ORG_API_KEY"

# Create/update a blob storage integration
curl -X PUT "https://cloud.langfuse.com/api/public/integrations/blob-storage" \
  -H "Authorization: Bearer $ORG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project-123",
    "type": "S3",
    "bucketName": "my-langfuse-exports",
    "region": "us-east-1",
    "accessKeyId": "AKIA...",
    "secretAccessKey": "secret...",
    "prefix": "langfuse/",
    "exportFrequency": "daily",
    "enabled": true,
    "forcePathStyle": false,
    "fileType": "JSONL",
    "exportMode": "FROM_TODAY"
  }'

Related Pages

• Environment:Langfuse_Langfuse_Node_24_Runtime