Create project

Create a new project in the organization. Returns the project with a newly minted service API key (serviceApiKey) for sending traces. Provide either teamId (existing team) or newTeamName (creates a new team). Requires project:create permission.

POST /api/v1/projects

Create a project

Python

import requests

url = "https://app.langwatch.ai/api/v1/projects"

payload = {
    "name": "<string>",
    "language": "<string>",
    "framework": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

201

{
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "language": "<string>",
  "framework": "<string>",
  "teamId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "serviceApiKey": "<string>",
  "serviceApiKeyId": "<string>"
}

Authorizations

Authorization · string · header · required

Admin API key for organization-level operations (managing projects, API keys). Create one in Settings > API Keys or via POST /api/api-keys. Format: sk-lw-{id}_{secret}.

Body

application/json

name · string · required

Project name

Required string length: 1 - 255

language · string · required

Programming language, such as python or typescript

Minimum string length: 1

framework · string · required

Framework in use, such as langchain or openai

Minimum string length: 1

teamId · string

Id of an existing team to put the project in

Minimum string length: 1

newTeamName · string

Create a team with this name and put the project in it

Required string length: 1 - 255

Response

201

application/json

Success

id · string · required

Minimum string length: 1

name · string · required

slug · string · required

language · string · required

framework · string · required

teamId · string · required

Minimum string length: 1

createdAt · string<date-time> · required

updatedAt · string<date-time> · required

serviceApiKey · string · required

Minimum string length: 1

serviceApiKeyId · string · required

Minimum string length: 1