Instance Management API

Note

This is only available in the Enterprise Edition. Please add your license key to activate it.

Overview

The Instance Management API allows administrators to programmatically manage organizations in a self-hosted Langfuse instance. This API is not available on Langfuse Cloud.

Resource	Description
Organizations	Create, update, and delete organizations
Organization API Keys	Generate and manage organization-level API keys

Note

Via the Organization API Keys, you can use the org-scoped routes to provision projects, users (SCIM), and permissions. Learn more here: Admin API.

Authentication

Configure an `ADMIN_API_KEY`

Configure an ADMIN_API_KEY in your environment configuration:

ADMIN_API_KEY=your-admin-api-key

Authenticate with the API

Then, authenticate with the API by setting the Authorization header:

Authorization: Bearer $ADMIN_API_KEY

API Reference

The API provides endpoints for creating, retrieving, updating, and deleting organizations. In addition, you can create, list, and delete API keys with an organization scope. Those can be used to authenticate with the Langfuse API and use management routes for projects and users (Admin API).

References:

API Reference: https://instance-management-api.reference.langfuse.com
OpenAPI spec: https://cloud.langfuse.com/generated/organizations-api/openapi.yml