# List LINA runs

`GET https://api.lingohub.com/v2/branches/{branchId}/lina-executions`

LingoHub API V2 (Beta) · [LINA Executions](https://developers.lingohub.com/reference/v2/operations/tags/lina-executions.md) · operation `listLinaExecutions`

Lists the LINA pre-translations started through the API on this branch, newest first, for the languages the key may read, as far back as the plan keeps LINA run history. Runs started in the app or by automations are not listed. Requires stack-level texts view permission.

## Parameters

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `branchId` | path | yes | string |  |
| `filter` | query | no |  | Filters and sorts the list: URL-encoded JSON of the schema `LinaExecutionFilter`. `where` holds exactly one `_and` or `_or` with an array of clauses; a clause is another `_and`/`_or` or a field with exactly one operator.… |
| `cursor` | query | no | string | Opaque pagination cursor from the `next_cursor` field of a previous response. Omit for the first page. |
| `limit` | query | no | integer | Maximum number of items to return per page (1-100). |

## Example request

```sh
curl --request GET \
  --url https://api.lingohub.com/v2/branches/BRANCH_ID/lina-executions \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Responses

- `200`: The runs.
- `400`: 
- `401`: 
- `403`: 
- `404`: 
- `429`: 
- `500`: 
- `503`: 

## OpenAPI definition

The complete definition of this operation, with every schema it references:

````json
{
  "openapi": "3.1.0",
  "info": {
    "title": "LingoHub API V2 (Beta)",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.lingohub.com",
      "description": "LingoHub"
    }
  ],
  "tags": [
    {
      "name": "LINA Executions",
      "description": "Pre-translate texts of a branch with the stack's LINA in the background, and follow the runs."
    }
  ],
  "paths": {
    "/v2/branches/{branchId}/lina-executions": {
      "get": {
        "tags": [
          "LINA Executions"
        ],
        "summary": "List LINA runs",
        "description": "Lists the LINA pre-translations started through the API on this branch, newest first, for the languages the key may read, as far back as the plan keeps LINA run history. Runs started in the app or by automations are not listed. Requires stack-level texts view permission.",
        "operationId": "listLinaExecutions",
        "parameters": [
          {
            "name": "branchId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Public id that is created from the type prefix of the corresponding resource and its UUID. I.e : For a project branch, a valid value would be : prb_0197c8f2-5a6b-7cde-8f12-3456789abcde",
              "pattern": "^prb_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "description": "Filters and sorts the list: URL-encoded JSON of the schema `LinaExecutionFilter`. `where` holds exactly one `_and` or `_or` with an array of clauses; a clause is another `_and`/`_or` or a field with exactly one operator. `sort` lists fields with `+` (ascending) or `-` (descending). An unsupported field, operator or value answers `400 invalid_filter` with a pointer into the filter.\n\n| Field | Type | Operators | Sort |\n|---|---|---|---|\n| `lina_execution[created_at]` | timestamp | `_eq` `_lt` `_gt` `_lte` `_gte` `_within` `_null` `_nnull` | yes |\n| `lina_execution[id]` | id | `_eq` `_ne` `_in` `_nin` | – |\n| `lina_execution[status]` | QUEUED \\| PROCESSING \\| SUCCEEDED \\| PARTIALLY_SUCCEEDED \\| FAILED \\| CANCELLED \\| SKIPPED | `_eq` `_ne` `_in` `_nin` | – |\n| `lina_execution[updated_at]` | timestamp | `_eq` `_lt` `_gt` `_lte` `_gte` `_within` `_null` `_nnull` | yes |\n",
            "required": false,
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LinaExecutionFilter"
                }
              }
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque pagination cursor from the `next_cursor` field of a previous response. Omit for the first page.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return per page (1-100).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20,
              "maximum": 100,
              "minimum": 1
            },
            "example": 20
          }
        ],
        "responses": {
          "200": {
            "description": "The runs.",
            "headers": {
              "RateLimit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LinaExecutionCollection"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "LinaExecutionFilter": {
        "type": "object",
        "additionalProperties": false,
        "description": "The filter of a list: which items to return and in which order.",
        "properties": {
          "where": {
            "$ref": "#/components/schemas/LinaExecutionFilterGroup"
          },
          "sort": {
            "type": "array",
            "description": "Fields to sort by, in order: `+` ascending, `-` descending.",
            "items": {
              "type": "string",
              "enum": [
                "+lina_execution[created_at]",
                "-lina_execution[created_at]",
                "+lina_execution[updated_at]",
                "-lina_execution[updated_at]"
              ]
            },
            "maxItems": 8
          }
        }
      },
      "LinaExecutionFilterGroup": {
        "type": "object",
        "additionalProperties": false,
        "description": "Exactly one of `_and` and `_or`, with the clauses it combines.",
        "maxProperties": 1,
        "minProperties": 1,
        "properties": {
          "_and": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinaExecutionFilterClause"
            },
            "minItems": 1
          },
          "_or": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinaExecutionFilterClause"
            },
            "minItems": 1
          }
        }
      },
      "LinaExecutionFilterClause": {
        "type": "object",
        "additionalProperties": false,
        "description": "A nested `_and`/`_or`, or one field with one operator.",
        "maxProperties": 1,
        "minProperties": 1,
        "properties": {
          "_and": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinaExecutionFilterClause"
            },
            "minItems": 1
          },
          "_or": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LinaExecutionFilterClause"
            },
            "minItems": 1
          },
          "lina_execution[created_at]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "format": "date-time"
              },
              "_lt": {
                "type": "string",
                "format": "date-time"
              },
              "_gt": {
                "type": "string",
                "format": "date-time"
              },
              "_lte": {
                "type": "string",
                "format": "date-time"
              },
              "_gte": {
                "type": "string",
                "format": "date-time"
              },
              "_within": {
                "type": "array",
                "description": "The lower and the upper bound.",
                "items": {
                  "type": "string",
                  "format": "date-time"
                },
                "maxItems": 2,
                "minItems": 2
              },
              "_null": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              },
              "_nnull": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              }
            }
          },
          "lina_execution[id]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "pattern": "^tp_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
              },
              "_ne": {
                "type": "string",
                "pattern": "^tp_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^tp_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^tp_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
                },
                "minItems": 1
              }
            }
          },
          "lina_execution[status]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "enum": [
                  "QUEUED",
                  "PROCESSING",
                  "SUCCEEDED",
                  "PARTIALLY_SUCCEEDED",
                  "FAILED",
                  "CANCELLED",
                  "SKIPPED"
                ]
              },
              "_ne": {
                "type": "string",
                "enum": [
                  "QUEUED",
                  "PROCESSING",
                  "SUCCEEDED",
                  "PARTIALLY_SUCCEEDED",
                  "FAILED",
                  "CANCELLED",
                  "SKIPPED"
                ]
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "QUEUED",
                    "PROCESSING",
                    "SUCCEEDED",
                    "PARTIALLY_SUCCEEDED",
                    "FAILED",
                    "CANCELLED",
                    "SKIPPED"
                  ]
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "QUEUED",
                    "PROCESSING",
                    "SUCCEEDED",
                    "PARTIALLY_SUCCEEDED",
                    "FAILED",
                    "CANCELLED",
                    "SKIPPED"
                  ]
                },
                "minItems": 1
              }
            }
          },
          "lina_execution[updated_at]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "format": "date-time"
              },
              "_lt": {
                "type": "string",
                "format": "date-time"
              },
              "_gt": {
                "type": "string",
                "format": "date-time"
              },
              "_lte": {
                "type": "string",
                "format": "date-time"
              },
              "_gte": {
                "type": "string",
                "format": "date-time"
              },
              "_within": {
                "type": "array",
                "description": "The lower and the upper bound.",
                "items": {
                  "type": "string",
                  "format": "date-time"
                },
                "maxItems": 2,
                "minItems": 2
              },
              "_null": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              },
              "_nnull": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              }
            }
          }
        }
      },
      "LinaExecutionCollection": {
        "type": "object",
        "description": "LINA runs started through the API on a branch.",
        "properties": {
          "object_type": {
            "type": "string",
            "description": "Always `LIST`.",
            "enum": [
              "LIST"
            ],
            "example": "LIST"
          },
          "has_more": {
            "type": "boolean",
            "description": "True if more items exist after this page. Iterate by repeating the request with the cursor query parameter set to next_cursor until has_more is false.",
            "example": true
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor token pointing past the last item of this page. Null on the last page. Pass it unchanged via the cursor query parameter to request the next page.",
            "example": "1uO9WTLnYqGAtIWkjDmz4VuJZWLkWMxXIH4Hkp2DTuRtPNQYBpkF6Q"
          },
          "data": {
            "type": "array",
            "description": "The list of items in this page.",
            "example": [
              {
                "object_type": "LINA_EXECUTION",
                "id": "tp_0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "branch_id": "prb_0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "target_language_code": "de",
                "status": "SUCCEEDED",
                "failure": null,
                "selected_segment_count": 10,
                "created_at": "2026-10-07T00:00:00.000Z",
                "updated_at": "2026-10-07T00:00:00.000Z"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/LinaExecution"
            }
          }
        },
        "required": [
          "data",
          "has_more",
          "next_cursor",
          "object_type"
        ]
      },
      "LinaExecution": {
        "type": "object",
        "description": "A LINA pre-translation of the selected texts of one language in a branch, started through the API. Every batch LINA finishes is saved right away, so a run that doesn't succeed may still have translated texts.",
        "properties": {
          "object_type": {
            "type": "string",
            "description": "Always `LINA_EXECUTION`.",
            "enum": [
              "LINA_EXECUTION"
            ],
            "example": "LINA_EXECUTION"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the run.",
            "example": "tp_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "minLength": 1,
            "pattern": "^tp_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "branch_id": {
            "type": "string",
            "description": "Branch whose texts the run translates.",
            "example": "prb_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "pattern": "^prb_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
          },
          "target_language_code": {
            "type": "string",
            "description": "Language the run translates into.",
            "example": "de"
          },
          "status": {
            "$ref": "#/components/schemas/LinaExecutionStatus",
            "description": "Where the run stands.",
            "example": "SUCCEEDED"
          },
          "failure": {
            "description": "Why the run didn't translate everything: set when `status` is `PARTIALLY_SUCCEEDED`, `FAILED` or `CANCELLED`, null otherwise.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/LinaExecutionFailure"
              },
              {
                "type": "null"
              }
            ]
          },
          "selected_segment_count": {
            "type": "integer",
            "format": "int32",
            "description": "Number of selected texts the run was to translate: translatable, with a source text and, with `only_empty`, without a translation. Counted when the run was started; it doesn't change while the run works.",
            "example": 10
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run was started.",
            "example": "2026-10-07T00:00:00.123Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run's status last changed.",
            "example": "2026-10-07T00:00:00.123Z"
          }
        },
        "required": [
          "branch_id",
          "created_at",
          "failure",
          "id",
          "object_type",
          "selected_segment_count",
          "status",
          "target_language_code",
          "updated_at"
        ]
      },
      "LinaExecutionStatus": {
        "type": "string",
        "description": "Where a LINA run stands. QUEUED and PROCESSING are pending; the others are final.\n  - SUCCEEDED: every selected text was translated.\n  - PARTIALLY_SUCCEEDED: part of the selection was translated; `failure` says why the rest wasn't.\n  - FAILED: nothing was translated, or the run stopped on an error; `failure` says why.\n  - CANCELLED: the queued run was cancelled because its selection changed; `failure` says so.\n  - SKIPPED: there was nothing to translate.\n",
        "enum": [
          "QUEUED",
          "PROCESSING",
          "SUCCEEDED",
          "PARTIALLY_SUCCEEDED",
          "FAILED",
          "CANCELLED",
          "SKIPPED"
        ]
      },
      "LinaExecutionFailure": {
        "type": "string",
        "description": "Why a LINA run did not translate everything it was asked to:\n  - INCOMPLETE_TRANSLATION: LINA could not translate some of the selected texts.\n  - INTERRUPTED: the run was interrupted and not repeated, because the engine may already have been called.\n  - SELECTION_CHANGED: the selected segments left the branch, or the project moved to another stack; select the segments again.\n  - EXECUTION_FAILED: an unexpected error stopped the run.\n",
        "enum": [
          "INCOMPLETE_TRANSLATION",
          "INTERRUPTED",
          "SELECTION_CHANGED",
          "EXECUTION_FAILED"
        ]
      },
      "Error": {
        "type": "object",
        "description": "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.",
        "properties": {
          "type": {
            "type": "string",
            "description": "URL identifying the problem type and pointing to its documentation.",
            "example": "https://api.lingohub.com/errors/resource-not-found"
          },
          "title": {
            "type": "string",
            "description": "Short, constant summary of the problem type.",
            "example": "Resource not found"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "description": "HTTP status code.",
            "example": 404
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation of this occurrence of the problem.",
            "example": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found."
          },
          "instance": {
            "type": "string",
            "description": "Path of the request that produced the problem.",
            "example": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde"
          },
          "code": {
            "$ref": "#/components/schemas/ErrorCode",
            "description": "Machine-readable problem type.",
            "example": "resource_not_found"
          },
          "request_id": {
            "type": "string",
            "description": "Correlation id of the request, also returned in the `X-Request-ID` header. Quote it when contacting support.",
            "example": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          },
          "errors": {
            "type": "array",
            "description": "Rejected fields or parameters. Present when the problem concerns specific fields or parameters.",
            "example": [
              {
                "detail": "must be at least 2 characters long",
                "pointer": "#/name",
                "parameter": "limit",
                "code": "minLength"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/FieldError"
            }
          },
          "required_permission": {
            "$ref": "#/components/schemas/RequiredPermission",
            "description": "The permission the API key lacks. Present on 403 responses."
          }
        },
        "required": [
          "code",
          "detail",
          "instance",
          "request_id",
          "status",
          "title",
          "type"
        ]
      },
      "ErrorCode": {
        "type": "string",
        "description": "Machine-readable problem type of a V2 error response. Each code has a fixed HTTP status and documentation at its `type` URL.",
        "enum": [
          "invalid_json",
          "invalid_parameter",
          "missing_parameter",
          "unknown_parameter",
          "invalid_filter",
          "invalid_cursor",
          "bad_request",
          "missing_api_key",
          "invalid_api_key",
          "expired_api_key",
          "revoked_api_key",
          "disabled_api_key",
          "insufficient_permissions",
          "resource_not_found",
          "route_not_found",
          "method_not_allowed",
          "not_acceptable",
          "precondition_failed",
          "content_too_large",
          "unsupported_media_type",
          "already_exists",
          "idempotency_outcome_unknown",
          "idempotency_key_in_use",
          "stack_not_empty",
          "branch_not_ready",
          "backup_not_ready",
          "backup_in_use",
          "default_branch_protected",
          "owner_membership_protected",
          "source_language_protected",
          "branch_limit_reached",
          "context_image_limit_reached",
          "automation_limit_reached",
          "translation_order_pending",
          "git_integration_not_configured",
          "branch_git_integration_not_configured",
          "git_integration_unauthorized",
          "conflict",
          "validation_failed",
          "idempotency_key_mismatch",
          "rate_limit_exceeded",
          "internal_error",
          "upstream_error",
          "service_unavailable",
          "upstream_timeout"
        ]
      },
      "FieldError": {
        "type": "object",
        "description": "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`.",
        "properties": {
          "detail": {
            "type": "string",
            "description": "Human-readable description of the problem.",
            "example": "must be at least 2 characters long"
          },
          "pointer": {
            "type": [
              "string",
              "null"
            ],
            "description": "JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.",
            "example": "#/name"
          },
          "parameter": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the offending query, path or header parameter, or of the multipart form field.",
            "example": "limit"
          },
          "code": {
            "$ref": "#/components/schemas/FieldErrorCode",
            "description": "Why the field or parameter was rejected.",
            "example": "minLength"
          }
        },
        "required": [
          "code",
          "detail",
          "parameter",
          "pointer"
        ]
      },
      "FieldErrorCode": {
        "type": "string",
        "description": "Why a field or parameter was rejected: the JSON Schema keyword of the violated rule, or one of the documented rules that no schema can express.",
        "enum": [
          "required",
          "type",
          "enum",
          "minLength",
          "maxLength",
          "minimum",
          "maximum",
          "pattern",
          "format",
          "additionalProperties",
          "minItems",
          "maxItems",
          "uniqueItems",
          "already_exists",
          "not_found",
          "not_supported",
          "unsupported_file_extension",
          "file_too_large",
          "file_empty",
          "invalid_archive",
          "empty_archive"
        ]
      },
      "RequiredPermission": {
        "type": "object",
        "description": "The permission the API key lacks, in the vocabulary of the API key permission settings.",
        "properties": {
          "scope": {
            "$ref": "#/components/schemas/PermissionScope",
            "description": "Where the permission applies.",
            "example": "STACK"
          },
          "target": {
            "$ref": "#/components/schemas/PermissionTarget",
            "description": "The area the permission governs.",
            "example": "SETTINGS"
          },
          "level": {
            "$ref": "#/components/schemas/PermissionLevel",
            "description": "The access level required.",
            "example": "MANAGE"
          }
        },
        "required": [
          "level",
          "scope",
          "target"
        ]
      },
      "PermissionScope": {
        "type": "string",
        "description": "Where a permission applies: `WORKSPACE` permissions cover workspace-level resources, `STACK` permissions the resources of a stack (its projects, branches, resources, languages, ...).",
        "enum": [
          "WORKSPACE",
          "STACK"
        ]
      },
      "PermissionTarget": {
        "type": "string",
        "description": "The area a permission governs.",
        "enum": [
          "GENERAL",
          "BILLING_SUBSCRIPTION",
          "WORKSPACES",
          "MEMBERS",
          "PLUGINS_INTEGRATIONS",
          "LOGS",
          "API_ACCESS",
          "STACKS",
          "TRANSLATION_ORDERS",
          "WORK_REPORTS",
          "STYLE_GUIDES",
          "GLOSSARIES",
          "TRANSLATION_MEMORIES",
          "LABELS",
          "AI_TRANSLATION",
          "QUICK_TRANSLATIONS",
          "SETTINGS",
          "ACTIVITIES",
          "RESOURCES",
          "CONTEXT_IMAGES",
          "LANGUAGES",
          "SEGMENT_KEYS",
          "SEGMENTS",
          "SEGMENT_TEXTS"
        ]
      },
      "PermissionLevel": {
        "type": "string",
        "description": "Access level of a permission: `MANAGE` includes `WRITE` and `VIEW`.",
        "enum": [
          "NO_ACCESS",
          "VIEW",
          "WRITE",
          "MANAGE"
        ]
      }
    },
    "headers": {
      "RateLimit": {
        "description": "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.",
        "schema": {
          "type": "string"
        }
      },
      "RateLimit-Policy": {
        "description": "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.",
        "schema": {
          "type": "string"
        }
      },
      "Retry-After": {
        "description": "Seconds to wait before retrying.",
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "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.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Invalid or missing API key.",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Insufficient permissions.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "NotFound": {
        "description": "The resource does not exist, or the API key cannot see it.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "InternalServerError": {
        "description": "An unexpected internal server error occurred.",
        "headers": {
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "RateLimit": {
            "$ref": "#/components/headers/RateLimit"
          },
          "RateLimit-Policy": {
            "$ref": "#/components/headers/RateLimit-Policy"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "description": "API key authentication. Create API keys in your LingoHub workspace settings. Keys use the `lh-api_` prefix. Pass the full key as the Bearer token.",
        "scheme": "bearer"
      }
    }
  }
}
````
