Create a project

What it does

Creates a new project. The authenticated user becomes the project owner. Project names are 3–32 characters. Locale tags must be valid (for example en, en-US, de-DE).

Request

POST /api/v1/projects

Auth	Required
Path parameters	None
Query parameters	None

Headers

Authorization: Bearer <your-api-key>
Content-Type: application/json

Body

{
  "name": "My mobile app",
  "baseLanguage": "en-US",
  "translationLanguages": ["de-DE", "fr-FR"]
}

Field	Type	Required	Description
name	string	yes	Project name (3–32 characters)
baseLanguage	string	yes	Source / fallback locale
translationLanguages	string[]	yes	Target locales (may be empty)

Example

curl -sS https://collingo.app/api/v1/projects \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My mobile app",
    "baseLanguage": "en-US",
    "translationLanguages": ["de-DE", "fr-FR"]
  }'

Response

200 OK

{
  "id": "clproj0123456789abcdefgh",
  "ownerId": "cluser0123456789abcdefgh",
  "owner": {
    "id": "cluser0123456789abcdefgh",
    "firstName": "Ada",
    "lastName": "Lovelace"
  },
  "name": "My mobile app",
  "baseLanguage": "en-US",
  "translationLanguages": ["de-DE", "fr-FR"],
  "createdAt": "2026-07-01T12:00:00Z",
  "capabilities": null,
  "memberQuota": null
}

Errors

Status	When
400	Validation failed
401	Missing or invalid API key (ERR_UNAUTHORIZED)
500	Database or internal error