API V2 (Beta) · LINAs
Create a LINA
curl --request POST \ --url https://api.lingohub.com/v2/linas \ --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"
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.post(url, json=payload, headers=headers)
print(response.json())const url = 'https://api.lingohub.com/v2/linas';const options = { method: 'POST', 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"
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("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 \"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") .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/v2/linas', [ '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")
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 \"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.Post, RequestUri = new Uri("https://api.lingohub.com/v2/linas"), 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);}Creates a LINA whose engines you choose; LingoHub-managed LINAs are set up by LingoHub. Only name and linguistic_engine_id are required; the context sources default to what the engine supports. The name must be unique in the workspace, ignoring case. The LINA gets its own actor, which its translations are attributed to, and default quality-check settings. Requires workspace-level AI translation management permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Optional. A unique key of 1 to 255 characters, for example a UUID, that makes a retry of this request safe: a retry with the same key and the same request returns the first result instead of running the operation again. See Safe retries.
Request Bodyrequired
Section titled “Request Bodyrequired”Request body to create a LINA whose engines you choose.
object
Name of the LINA; it must be unique in the workspace, ignoring case.
Example
LocalizationDescription of the LINA.
Example
Product translatorColor of the LINA’s icon, as a hexadecimal RGB value. Defaults to #C084FC.
Example
#C084FCEngine the LINA translates with; it must be enabled in the workspace (GET /v2/linguistic-engines lists them).
Example
engine_0197c8f2-5a6b-7cde-8f12-3456789abcdeGlossary of the workspace the LINA uses for translation and for the terminology check. Left out or null: none.
Example
gls_0197c8f2-5a6b-7cde-8f12-3456789abcdeStyle guide of the workspace the LINA follows when translating and for the style checks. Left out or null: none.
Example
sg_0197c8f2-5a6b-7cde-8f12-3456789abcdeWhich context the LINA sends along with each text it translates. A source left out is enabled when the engine supports it.
object
Send the rules of the LINA’s style guide.
Example
trueSend the terms of the LINA’s glossary.
Example
trueSend the labels of the segment.
Example
trueSend the description of the segment.
Example
trueSend similar translations from the translation memory.
Example
falseExample
{ "is_translation_memory_enabled": false}Whether the LINA reuses a translation-memory match with exactly the same source text instead of translating it. Defaults to false.
Example
falseStacks of the workspace the LINA may work in; an empty list allows none. Left out or null: every stack.
Example
[ "stack_0197c8f2-5a6b-7cde-8f12-3456789abcde"]Engines the LINA uses for single target languages instead of linguistic_engine_id, one per language. Defaults to none.
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 was created.
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”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.
True when the original successful result was replayed for this key.
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.
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.
URL of the new LINA.
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.
already_exists: another LINA of the workspace has this name (#/name). An unresolved request returns idempotency_outcome_unknown without Retry-After; inspect the affected resource before starting a new operation. A recent request with the same Idempotency-Key is still being processed (idempotency_key_in_use); 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 for an in-progress keyed request; absent for other conflicts.
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 exceeds the body or upload limit; no operation was performed.
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).
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.