Skip to main content

​
Intro

The Teams API lets you manage LangWatch teams via REST. Teams are organizational units that group projects and members together. This API is designed for service-to-service automation (e.g. provisioning team structures for new departments, cleaning up orphaned teams from test runs), not for end-user access.

​
Authentication

The Teams API requires an organization-level API key with team:manage permission (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

MethodPathDescription
GET/api/teamsList all teams in the organization
POST/api/teamsCreate a new team
GET/api/teams/{id}Get team details
PATCH/api/teams/{id}Update a team
DELETE/api/teams/{id}Archive a team (soft-delete)
GET/api/teams/{id}/membersList team members
POST/api/teams/{id}/membersAdd a member to the team
DELETE/api/teams/{id}/members/{userId}Remove a member from the team
GET/api/teams/{id}/projectsList projects in the team

​
Soft Delete

DELETE does not permanently remove a team. It sets an archivedAt timestamp, making the team invisible to list and get operations. Archived teams can still be referenced in historical data (e.g. past project associations).

​
Typical Flow

  1. Create an admin API key in Settings > API Keys with team:manage permission
  2. Call POST /api/teams with a team name
  3. Use the returned team id when creating projects via the Projects API, or later move an existing project by updating its teamId
# Create team
curl -X POST https://app.langwatch.ai/api/teams \
  -H "Authorization: Bearer sk-lw-..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Engineering"}'

# Use team ID to create a project
curl -X POST https://app.langwatch.ai/api/projects \
  -H "Authorization: Bearer sk-lw-..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My Project", "teamId": "<team_id>", "language": "python", "framework": "langchain"}'