Overview - LangWatch

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, because they lack organization context.

Endpoints

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

Dashboards boards

These routes read the boards of the Dashboards area in one project. Unlike the routes above, they take the project API key in the X-Auth-Token header, not an organization key.

Method	Path	Description
`GET`	`/api/v1/projects/{projectId}/analytics/boards`	List the project’s boards, each with its `widgetCount`
`GET`	`/api/v1/projects/{projectId}/analytics/boards/{boardId}`	Get one board

A board in another project answers 404.

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/v1/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/v1/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, because you cannot retrieve it later.

​Intro

​Authentication

​Endpoints

​Dashboards boards

​Moving a Project to Another Team

​Typical Flow

Intro

Authentication

Endpoints

Dashboards boards

Moving a Project to Another Team

Typical Flow