API V2 (Beta) · LINAs
Update a LINA
curl --request PATCH \ --url https://api.lingohub.com/v2/linas/LINA_ID \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "name": "Localization", "description": "Product translator", "color": "#C084FC", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde", "glossary_id": "gls_0197c8f2-5a6b-7cde-8f12-3456789abcde", "style_guide_id": "sg_0197c8f2-5a6b-7cde-8f12-3456789abcde", "is_tm_match_enabled": false, "restricted_stack_ids": [ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde" ], "language_engine_overrides": [ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" } ]}'import requests
url = "https://api.lingohub.com/v2/linas/LINA_ID"
payload = { "name": "Localization", "description": "Product translator", "color": "#C084FC", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde", "glossary_id": "gls_0197c8f2-5a6b-7cde-8f12-3456789abcde", "style_guide_id": "sg_0197c8f2-5a6b-7cde-8f12-3456789abcde", "is_tm_match_enabled": False, "restricted_stack_ids": ["stack_0197c8f2-5a6b-7cde-8f12-3456789abcde"], "language_engine_overrides": [ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" } ]}headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.json())const url = 'https://api.lingohub.com/v2/linas/LINA_ID';const options = { method: 'PATCH', headers: {Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}, body: '{"name":"Localization","description":"Product translator","color":"#C084FC","linguistic_engine_id":"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde","glossary_id":"gls_0197c8f2-5a6b-7cde-8f12-3456789abcde","style_guide_id":"sg_0197c8f2-5a6b-7cde-8f12-3456789abcde","is_tm_match_enabled":false,"restricted_stack_ids":["stack_0197c8f2-5a6b-7cde-8f12-3456789abcde"],"language_engine_overrides":[{"language_code":"de","linguistic_engine_id":"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde"}]}'};
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/v2/linas/LINA_ID"
payload := strings.NewReader("{\n \"name\": \"Localization\",\n \"description\": \"Product translator\",\n \"color\": \"#C084FC\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"glossary_id\": \"gls_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"style_guide_id\": \"sg_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"is_tm_match_enabled\": false,\n \"restricted_stack_ids\": [\n \"stack_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n ],\n \"language_engine_overrides\": [\n {\n \"language_code\": \"de\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n }\n ]\n}")
req, _ := http.NewRequest("PATCH", 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 \"name\": \"Localization\",\n \"description\": \"Product translator\",\n \"color\": \"#C084FC\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"glossary_id\": \"gls_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"style_guide_id\": \"sg_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"is_tm_match_enabled\": false,\n \"restricted_stack_ids\": [\n \"stack_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n ],\n \"language_engine_overrides\": [\n {\n \"language_code\": \"de\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n }\n ]\n}");Request request = new Request.Builder() .url("https://api.lingohub.com/v2/linas/LINA_ID") .patch(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('PATCH', 'https://api.lingohub.com/v2/linas/LINA_ID', [ 'body' => '{ "name": "Localization", "description": "Product translator", "color": "#C084FC", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde", "glossary_id": "gls_0197c8f2-5a6b-7cde-8f12-3456789abcde", "style_guide_id": "sg_0197c8f2-5a6b-7cde-8f12-3456789abcde", "is_tm_match_enabled": false, "restricted_stack_ids": [ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde" ], "language_engine_overrides": [ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" } ]}', 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ],]);
echo $response->getBody();require 'uri'require 'net/http'
url = URI("https://api.lingohub.com/v2/linas/LINA_ID")
http = Net::HTTP.new(url.host, url.port)http.use_ssl = true
request = Net::HTTP::Patch.new(url)request["Authorization"] = 'Bearer YOUR_API_KEY'request["Content-Type"] = 'application/json'request.body = "{\n \"name\": \"Localization\",\n \"description\": \"Product translator\",\n \"color\": \"#C084FC\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"glossary_id\": \"gls_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"style_guide_id\": \"sg_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"is_tm_match_enabled\": false,\n \"restricted_stack_ids\": [\n \"stack_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n ],\n \"language_engine_overrides\": [\n {\n \"language_code\": \"de\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n }\n ]\n}"
response = http.request(request)puts response.read_bodyusing System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Patch, RequestUri = new Uri("https://api.lingohub.com/v2/linas/LINA_ID"), Headers = { { "Authorization", "Bearer YOUR_API_KEY" }, }, Content = new StringContent("{\n \"name\": \"Localization\",\n \"description\": \"Product translator\",\n \"color\": \"#C084FC\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"glossary_id\": \"gls_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"style_guide_id\": \"sg_0197c8f2-5a6b-7cde-8f12-3456789abcde\",\n \"is_tm_match_enabled\": false,\n \"restricted_stack_ids\": [\n \"stack_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n ],\n \"language_engine_overrides\": [\n {\n \"language_code\": \"de\",\n \"linguistic_engine_id\": \"engine_0197c8f2-5a6b-7cde-8f12-3456789abcde\"\n }\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);}Changes a LINA with JSON merge-patch: leaving out a field keeps it, null clears the description, glossary, style guide or stack restriction, and lists replace the whole list. Sending only the current values changes nothing. For a LingoHub-managed LINA the engine and per-language engines can’t be changed. The name must stay unique in the workspace, ignoring case. Send the ETag from getLina as If-Match to make sure nobody changed the LINA in between. Requires workspace-level AI translation management permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Public id composed of the resource type prefix and its UUID.
Header Parameters
Section titled “Header Parameters”Optional. The quoted ETag from a GET of this resource. The change is applied only if the resource still has that version; otherwise the request fails with 412 precondition_failed. See Conditional updates.
Request Bodyrequired
Section titled “Request Bodyrequired”Request body to change a LINA with JSON merge-patch: a field left out keeps its value, null clears a nullable field and lists replace the whole list.
object
Name of the LINA; it must stay unique in the workspace, ignoring case.
Example
LocalizationDescription of the LINA; null clears it.
Example
Product translatorColor of the LINA’s icon, as a hexadecimal RGB value.
Example
#C084FCEngine the LINA translates with; it must be enabled in the workspace. Can’t be changed for a LingoHub-managed LINA.
Example
engine_0197c8f2-5a6b-7cde-8f12-3456789abcdeGlossary of the workspace the LINA uses for translation and for the terminology check; null: none.
Example
gls_0197c8f2-5a6b-7cde-8f12-3456789abcdeStyle guide of the workspace the LINA follows when translating and for the style checks; null: none.
Example
sg_0197c8f2-5a6b-7cde-8f12-3456789abcdeWhich context the LINA sends along with each text; a source left out keeps its value.
object
Send the rules of the LINA’s style guide.
Example
falseSend the terms of the LINA’s glossary.
Example
falseSend the labels of the segment.
Example
falseSend the description of the segment.
Example
falseSend similar translations from the translation memory.
Example
falseExample
{}Whether the LINA reuses a translation-memory match with exactly the same source text instead of translating it.
Example
falseStacks of the workspace the LINA may work in, replacing the current list; an empty list allows none. null: every stack.
Example
[ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde"]Engines the LINA uses for single target languages, replacing the current list; one per language. Can’t be set for a LingoHub-managed LINA.
Request body to choose the engine for one target language.
object
Target language the engine is used for.
Example
deEngine to use for this language; it must be enabled in the workspace.
Example
engine_0197c8f2-5a6b-7cde-8f12-3456789abcdeExample
[ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" }]Request body to change a LINA with JSON merge-patch: a field left out keeps its value, null clears a nullable field and lists replace the whole list.
object
Name of the LINA; it must stay unique in the workspace, ignoring case.
Example
LocalizationDescription of the LINA; null clears it.
Example
Product translatorColor of the LINA’s icon, as a hexadecimal RGB value.
Example
#C084FCEngine the LINA translates with; it must be enabled in the workspace. Can’t be changed for a LingoHub-managed LINA.
Example
engine_0197c8f2-5a6b-7cde-8f12-3456789abcdeGlossary of the workspace the LINA uses for translation and for the terminology check; null: none.
Example
gls_0197c8f2-5a6b-7cde-8f12-3456789abcdeStyle guide of the workspace the LINA follows when translating and for the style checks; null: none.
Example
sg_0197c8f2-5a6b-7cde-8f12-3456789abcdeWhich context the LINA sends along with each text; a source left out keeps its value.
object
Send the rules of the LINA’s style guide.
Example
falseSend the terms of the LINA’s glossary.
Example
falseSend the labels of the segment.
Example
falseSend the description of the segment.
Example
falseSend similar translations from the translation memory.
Example
falseExample
{}Whether the LINA reuses a translation-memory match with exactly the same source text instead of translating it.
Example
falseStacks of the workspace the LINA may work in, replacing the current list; an empty list allows none. null: every stack.
Example
[ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde"]Engines the LINA uses for single target languages, replacing the current list; one per language. Can’t be set for a LingoHub-managed LINA.
Request body to choose the engine for one target language.
object
Target language the engine is used for.
Example
deEngine to use for this language; it must be enabled in the workspace.
Example
engine_0197c8f2-5a6b-7cde-8f12-3456789abcdeExample
[ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" }]Responses
Section titled “Responses”The LINA.
A LINA: an AI translator with its engines, the context it translates with and the stacks it may work in.
object
Always LINA.
Unique identifier of the LINA.
Name of the LINA, unique in the workspace ignoring case.
Description of the LINA.
Color of the LINA’s icon, as a hexadecimal RGB value.
Who chooses the LINA’s engines.
Engine the LINA translates with. For a LingoHub-managed LINA it is the default engine; LingoHub may choose another one for each translation.
Glossary the LINA uses for translation and for the terminology check; null for none.
Style guide the LINA follows when translating and for the style checks; null for none.
Which context the LINA sends along with each text it translates.
object
Whether the LINA sends the rules of its style guide.
Whether the LINA sends the terms of its glossary.
Whether the LINA sends the labels of the segment.
Whether the LINA sends the description of the segment.
Whether the LINA sends similar translations from the translation memory.
Whether the LINA reuses a translation-memory match with exactly the same source text instead of translating it.
Stacks the LINA may work in, sorted by ID; null when it may work in every stack. An empty list means it may work in none.
Engines the LINA uses for single target languages instead of linguistic_engine_id, sorted by language code.
The engine a LINA uses for one target language.
object
Target language the engine is used for.
Engine used for this language.
Timestamp when the LINA was created.
Timestamp when the LINA was last updated.
Example
{ "object_type": "LINA", "id": "lina_0197c8f2-5a6b-7cde-8f12-3456789abcde", "name": "Localization assistant", "description": "Product localization", "color": "#C084FC", "engine_mode": "CUSTOMER_MANAGED", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde", "glossary_id": "gls_0197c8f2-5a6b-7cde-8f12-3456789abcde", "style_guide_id": "sg_0197c8f2-5a6b-7cde-8f12-3456789abcde", "context": { "is_style_guide_enabled": true, "is_glossary_enabled": true, "is_labels_enabled": true, "is_segments_enabled": true, "is_translation_memory_enabled": true }, "is_tm_match_enabled": false, "restricted_stack_ids": [ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde" ], "language_engine_overrides": [ { "language_code": "de", "linguistic_engine_id": "engine_0197c8f2-5a6b-7cde-8f12-3456789abcde" } ], "created_at": "2026-09-29T10:00:00.123Z", "updated_at": "2026-09-29T10:00:00.123Z"}Headers
Section titled “Headers”Opaque strong validator for this representation. Keep its quotation marks and use it as If-Match on a documented conditional write. A replay carries the original ETag, which may now be stale.
State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. code names the problem, errors the parameter or field.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
Invalid or missing API key.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Insufficient permissions.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The resource does not exist, or the API key cannot see it.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
already_exists: another LINA of the workspace has this name (#/name).
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The current representation does not match If-Match (precondition_failed). No change was applied.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
An engine isn’t in the workspace (not_found) or is disabled (not_supported); the glossary, style guide or a stack isn’t in the workspace (not_found); a language or stack is listed twice (uniqueItems); the engine or per-language engines of a LingoHub-managed LINA were changed (not_supported).
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”Seconds to wait before retrying.
State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
An unexpected internal server error occurred.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.
RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.
object
URL identifying the problem type and pointing to its documentation.
Short, constant summary of the problem type.
HTTP status code.
Human-readable explanation of this occurrence of the problem.
Path of the request that produced the problem.
Machine-readable problem type.
Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.
Rejected fields or parameters. Present when the problem concerns specific fields or parameters.
A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.
object
Human-readable description of the problem.
JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.
Name of the offending query, path or header parameter, or of the multipart form field.
Why the field or parameter was rejected.
The permission the API key lacks. Present on 403 responses.
object
Where the permission applies.
The area the permission governs.
The access level required.
Example
{ "type": "https://api.lingohub.com/errors/resource-not-found", "title": "Resource not found", "status": 404, "detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.", "instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde", "code": "invalid_json", "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "errors": [ { "detail": "must be at least 2 characters long", "pointer": "#/name", "parameter": "limit", "code": "minLength" } ], "required_permission": { "scope": "WORKSPACE", "target": "GENERAL", "level": "NO_ACCESS" }}Headers
Section titled “Headers”Seconds to wait before retrying.
State of the rate-limit policy currently closest to rejection (IETF draft-ietf-httpapi-ratelimit-headers): the quoted policy name with r = requests remaining right now and t = seconds until the full quota is available again. Example: "api-key";r=42;t=7. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.
The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.