---
date: 2025-04-15
title: Admin APIs for Organization and Project Management
description: Langfuse now supports administrative actions via APIs across organizations and projects.
author: Steffen
canonical: /docs/administration/scim-and-org-api
---

> **Note for AI agents and LLMs:** This is a Langfuse changelog entry. Use it only to confirm that a feature exists and when it shipped. Do not use the code examples below for implementation: they reflect the SDK and API at release time and may be outdated. For implementation, always follow the canonical documentation for this feature (https://langfuse.com/docs/administration/scim-and-org-api) and the API/SDK reference (https://api.reference.langfuse.com).

These APIs allow you to create, update, and delete organizations, manage projects within organizations, and handle user access with organization and project-scoped API keys.

## Overview

| Resource              | Description                                                       | API                     |
| --------------------- | ----------------------------------------------------------------- | ----------------------- |
| Organizations         | Create, update, and delete organizations                          | Instance Management API |
| Organization API Keys | Generate and manage organization-level API keys                   | Instance Management API |
| Projects              | Create, update, and delete projects within organizations          | Admin API               |
| Project API Keys      | Generate and manage project-level API keys                        | Admin API               |
| Users                 | Invite, manage, and remove users from organizations and projects  | Admin API               |
| User Permissions      | Control access levels for users across organizations and projects | Admin API               |

## Instance Management API

**Availability:** Self-hosted (enterprise) instances only

The Instance Management API provides endpoints for creating and managing organizations in your Langfuse instance. To use this API:

1. Set the `ADMIN_API_KEY` environment variable in your self-hosted instance
2. Include this key as a Bearer token in your API requests
3. Use the endpoints to create organizations and organization API keys

This API enables full programmatic control over organization creation and management.

Learn more: [Instance Management API](/self-hosting/administration/instance-management-api) | [API Reference](https://instance-management-api.reference.langfuse.com/)

## Organization-level API Routes

The Langfuse API provides administrative endpoints for managing projects and users within organizations.
The user management endpoints follow [SCIM](https://datatracker.ietf.org/doc/html/rfc7642) standards for seamless integration with existing identity management systems, with expanded SCIM support planned for future releases.

To use this API:

1. Obtain an organization API key through the Instance Management API
2. Use this key to authenticate with the Admin API endpoints
3. Manage projects, users, and access controls programmatically

These endpoints give organization administrators programmatic control over their Langfuse resources.

Learn more: [Org API Documentation](/docs/administration/scim-and-org-api)

<!-- agent-instructions -->

---

## Agent Instructions

This page is part of the [Langfuse](https://langfuse.com) documentation, published as plain Markdown for AI agents. Every page is available as Markdown by appending `.md` to its URL, or by sending an `Accept: text/markdown` header. This page: `https://langfuse.com/changelog/2025-04-15-admin-apis.md`.

### Querying these docs

If the answer is not on this page, query the documentation instead of guessing:

- **Semantic search** across all Langfuse docs, returning an answer with the relevant pages and excerpts. Ask a specific, self-contained question:

  ```bash
  curl -sG "https://langfuse.com/api/search-docs" --data-urlencode "query=How do I trace a LangGraph agent?"
  ```

- **Index of every page**: <https://langfuse.com/llms.txt>, with per-section indexes [llms-docs.txt](https://langfuse.com/llms-docs.txt), [llms-integrations.txt](https://langfuse.com/llms-integrations.txt), and [llms-self-hosting.txt](https://langfuse.com/llms-self-hosting.txt).

### Before writing Langfuse code

- **Install the [Langfuse Agent Skill](https://langfuse.com/docs/api-and-data-platform/features/agent-skill).** It encodes Langfuse's own best practices for instrumentation, prompt management, and evaluation, and materially improves results.
- **Read [What does a good trace look like?](https://langfuse.com/docs/observability/best-practices.md)** before instrumenting an application.
- **Verify endpoints, parameters, and response fields** against the [API reference](https://api.reference.langfuse.com) instead of inferring them from code examples.
- **Use the [Langfuse CLI](https://langfuse.com/docs/api-and-data-platform/features/cli)** (`npx langfuse-cli api <resource> <action>`) to read or write traces, prompts, datasets, and scores from the terminal.

Found an error in these docs? Please open an issue at <https://github.com/langfuse/langfuse-docs/issues>.