List Languages

GET /api/v1/content/projects/:projectId/languages

Returns all languages configured for a project, including locale codes, display names, and which language is the default. Use this endpoint to discover available locales before requesting translated content.

Authentication

Requires a Content API key. See Authentication.

Path parameters

Parameter	Type	Required	Description
`projectId`	string	Yes	The project ID

Response

{
  "object": "list",
  "data": [
    {
      "code": "en-us",
      "name": "English (US)",
      "isDefault": true
    },
    {
      "code": "fr-fr",
      "name": "French (France)",
      "isDefault": false
    },
    {
      "code": "vi-vn",
      "name": "Vietnamese",
      "isDefault": false
    }
  ]
}

Response fields

Field	Type	Description
`object`	string	Always `"list"`
`data`	array	Array of language objects
`data[].code`	string	Locale code (e.g., `en-us`, `fr-fr`). Use this value as the `locale` parameter in other endpoints.
`data[].name`	string	Human-readable language name
`data[].isDefault`	boolean	Whether this is the project’s default language. The default language is listed first.

Pass the code value as the locale query parameter to:

Get Page — get translated page content
Get Theme Settings — get static translations

Errors

Code	Status	When
`UNAUTHORIZED`	401	Missing or invalid API key
`FORBIDDEN`	403	API key does not have access to this project
`PROJECT_NOT_FOUND`	404	Project does not exist or was deleted
`INVALID_PARAMS`	400	Missing `projectId`
`INTERNAL_ERROR`	500	Unexpected server error

Examples

cURL
TypeScript
Python

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://studio.weaverse.io/api/v1/content/projects/clx1abc23def456ghij/languages"

const res = await fetch(
  `https://studio.weaverse.io/api/v1/content/projects/${projectId}/languages`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
)
const { data: languages } = await res.json()

// Build locale switcher
const defaultLocale = languages.find((l) => l.isDefault)?.code
const availableLocales = languages.map((l) => l.code)

import requests

res = requests.get(
    f"https://studio.weaverse.io/api/v1/content/projects/{project_id}/languages",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
languages = res.json()["data"]
default_locale = next(l["code"] for l in languages if l["isDefault"])

Overview

Endpoints

List Languages

List Languages

Authentication

Path parameters

Response

Response fields

Errors

Examples

Overview

Endpoints

​List Languages

​Authentication

​Path parameters

​Response

​Response fields

​Errors

​Examples

List Languages

Authentication

Path parameters

Response

Response fields

Errors

Examples