Overview

Intro

The Projects API lets you manage LangWatch projects via REST. When you create a project, a project-scoped service API key is automatically generated and returned — ready to use for sending traces. This API is designed for service-to-service automation (e.g. an internal tool that scaffolds new projects), not for end-user access.

Authentication

The Projects API requires an organization-level API key (created in Settings > API Keys). Pass it as a Bearer token:

Authorization: Bearer sk-lw-<id>_<secret>

Project API keys (X-Auth-Token) cannot be used here — they lack organization context.

Endpoints

Method	Path	Description
`GET`	`/api/projects`	List all projects in the organization
`POST`	`/api/projects`	Create a new project (returns a service API key)
`GET`	`/api/projects/{id}`	Get project details
`PATCH`	`/api/projects/{id}`	Update project fields (including moving to a different team)
`DELETE`	`/api/projects/{id}`	Archive a project
`GET`	`/api/projects/{id}/api-key`	Get the project’s API key
`POST`	`/api/projects/{id}/regenerate-api-key`	Regenerate the project API key

Moving a Project to Another Team

You can move a project to a different team by including teamId in the PATCH request:

curl -X PATCH https://app.langwatch.ai/api/projects/<project_id> \
  -H "Authorization: Bearer sk-lw-..." \
  -H "Content-Type: application/json" \
  -d '{"teamId": "<destination_team_id>"}'

Moving a project changes its access boundary. Members who had access through the source team will lose inherited access, while members of the destination team will gain it. Project-level access overrides are preserved.

Typical Flow

Create an admin API key in Settings > API Keys with organization:manage permission
Call POST /api/projects with the project name and either an existing teamId or a newTeamName
Store the returned serviceApiKey and project id
Use both values in your application:

LANGWATCH_API_KEY=<serviceApiKey>
LANGWATCH_PROJECT_ID=<project id>

The serviceApiKey is shown only once in the create response. Store it securely — you cannot retrieve it later.

Traces

Datasets

Evaluators

Built-in Evaluators

Evaluations v3

Monitors

Prompts

Annotations

Scenarios

Scenario Events

Simulation Runs

Suites

Agents

Triggers

Workflows

Dashboards

Graphs

Analytics

Secrets

Model Providers

Projects

Teams

Groups

API Keys

Gateway: Virtual Keys

Gateway: Provider Bindings

Gateway: Budgets

Gateway: Cache Rules

Intro

Authentication

Endpoints

Moving a Project to Another Team

Typical Flow

​Intro

​Authentication

​Endpoints

​Moving a Project to Another Team

​Typical Flow

Intro

Authentication

Endpoints

Moving a Project to Another Team

Typical Flow