API V1 · Projects
Create a project
curl --request POST \ --url https://api.lingohub.com/v1/WORKSPACE_URL/projects \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "title": "My Mobile App", "description": "Localization project for the mobile application", "resourceType": "json.standard", "sourceLanguageCode": "en", "targetLanguageCodes": [ "de", "fr", "es" ]}'import requests
url = "https://api.lingohub.com/v1/WORKSPACE_URL/projects"
payload = { "title": "My Mobile App", "description": "Localization project for the mobile application", "resourceType": "json.standard", "sourceLanguageCode": "en", "targetLanguageCodes": ["de", "fr", "es"]}headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())const url = 'https://api.lingohub.com/v1/WORKSPACE_URL/projects';const options = { method: 'POST', headers: {Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}, body: '{"title":"My Mobile App","description":"Localization project for the mobile application","resourceType":"json.standard","sourceLanguageCode":"en","targetLanguageCodes":["de","fr","es"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}package main
import ( "fmt" "strings" "net/http" "io")
func main() {
url := "https://api.lingohub.com/v1/WORKSPACE_URL/projects"
payload := strings.NewReader("{\n \"title\": \"My Mobile App\",\n \"description\": \"Localization project for the mobile application\",\n \"resourceType\": \"json.standard\",\n \"sourceLanguageCode\": \"en\",\n \"targetLanguageCodes\": [\n \"de\",\n \"fr\",\n \"es\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer YOUR_API_KEY") req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{\n \"title\": \"My Mobile App\",\n \"description\": \"Localization project for the mobile application\",\n \"resourceType\": \"json.standard\",\n \"sourceLanguageCode\": \"en\",\n \"targetLanguageCodes\": [\n \"de\",\n \"fr\",\n \"es\"\n ]\n}");Request request = new Request.Builder() .url("https://api.lingohub.com/v1/WORKSPACE_URL/projects") .post(body) .addHeader("Authorization", "Bearer YOUR_API_KEY") .addHeader("Content-Type", "application/json") .build();
Response response = client.newCall(request).execute();<?php
$client = new \GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.lingohub.com/v1/WORKSPACE_URL/projects', [ 'body' => '{ "title": "My Mobile App", "description": "Localization project for the mobile application", "resourceType": "json.standard", "sourceLanguageCode": "en", "targetLanguageCodes": [ "de", "fr", "es" ]}', 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ],]);
echo $response->getBody();require 'uri'require 'net/http'
url = URI("https://api.lingohub.com/v1/WORKSPACE_URL/projects")
http = Net::HTTP.new(url.host, url.port)http.use_ssl = true
request = Net::HTTP::Post.new(url)request["Authorization"] = 'Bearer YOUR_API_KEY'request["Content-Type"] = 'application/json'request.body = "{\n \"title\": \"My Mobile App\",\n \"description\": \"Localization project for the mobile application\",\n \"resourceType\": \"json.standard\",\n \"sourceLanguageCode\": \"en\",\n \"targetLanguageCodes\": [\n \"de\",\n \"fr\",\n \"es\"\n ]\n}"
response = http.request(request)puts response.read_bodyusing System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.lingohub.com/v1/WORKSPACE_URL/projects"), Headers = { { "Authorization", "Bearer YOUR_API_KEY" }, }, Content = new StringContent("{\n \"title\": \"My Mobile App\",\n \"description\": \"Localization project for the mobile application\",\n \"resourceType\": \"json.standard\",\n \"sourceLanguageCode\": \"en\",\n \"targetLanguageCodes\": [\n \"de\",\n \"fr\",\n \"es\"\n ]\n}") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}Creates a new localization project within the specified workspace. Requires the project title, resource type (file format), source language, and optionally target languages and a description.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”WorkspaceUrl
Request Bodyrequired
Section titled “Request Bodyrequired”Request body for creating a new localization project.
object
The title of the project.
Example
My Mobile AppOptional project description.
Example
Localization project for the mobile applicationThe resource file type for the project. Determines the file format used for import/export.
Example
json.standardThe source (base) language code of the project. This is the language from which translations are made.
Example
enThe list of target language codes to translate into.
Example
[ "de", "fr", "es"]Responses
Section titled “Responses”Successfully created the project. Returns the detailed project information.
Detailed information about a localization project including its locales, owner, and HATEOAS links.
object
The title of the project.
Email address of the project’s owner.
Project description.
The list of locale codes configured for the project.
Timestamp when the project was created.
Timestamp when the project was last updated.
HATEOAS links for navigating to related resources (e.g. project resources, status).
object
Examples
Newly created JSON project
CreatedProject
{ "title": "My Mobile App", "description": "Localization project for our mobile application", "links": [ { "rel": "self", "href": "https://api.lingohub.com/v1/my-workspace/projects/my-mobile-app" }, { "rel": "resources", "href": "https://api.lingohub.com/v1/my-workspace/projects/my-mobile-app/resources" } ], "owner_email": "user@example.com", "project_locales": [ "en", "de", "fr" ], "created_at": "2025-01-15T10:30:00+0000", "updated_at": "2025-01-15T10:30:00+0000"}Unauthorized: Authentication credentials are missing or invalid.
object
Example generated
{ "url": "example", "message": "example", "text": "example"}Forbidden: The authenticated user does not have settings management permission on this workspace.
object
Example generated
{ "url": "example", "message": "example", "text": "example"}Not Found: The specified workspace does not exist.
object
Example generated
{ "url": "example", "message": "example", "text": "example"}Unprocessable Entity: Validation failed for the request body (e.g. missing title, invalid resource type, or invalid language code).