Use project IDs to prevent duplicate projects after rename

Applies to:

Plan - Any
Deployment - Any

Summary When a project is renamed, SDK code that references the old project name will automatically create a new duplicate project. To prevent this, use stable project_id parameters instead of project names in SDK initialization and environment variables.

Configuration Steps

Step 1: Locate your project ID

Find the project ID in Project Settings or retrieve it via the Projects API. Project IDs remain stable across renames.

Step 2: Update SDK initialization

Replace project name parameters with project ID parameters in your SDK initialization code. Python SDK:

# Before (using name - creates duplicate after rename)
braintrust.init(project="my-project-name")

# After (using ID - stable across renames)
braintrust.init(project_id="proj_abc123xyz")

TypeScript SDK:

// Before (using name - creates duplicate after rename)
braintrust.init({ project: "my-project-name" });

// After (using ID - stable across renames)
braintrust.init({ projectId: "proj_abc123xyz" });

Step 3: Update environment variables and configuration

Replace project name references in environment variables, CI/CD pipelines, and API calls with the corresponding project IDs.

​Configuration Steps

​Step 1: Locate your project ID

​Step 2: Update SDK initialization

​Step 3: Update environment variables and configuration

Configuration Steps

Step 1: Locate your project ID

Step 2: Update SDK initialization

Step 3: Update environment variables and configuration