# List workspace audit logs

`GET https://api.lingohub.com/v2/audit-logs`

LingoHub API V2 (Beta) · [Audit Logs](https://developers.lingohub.com/reference/v2/operations/tags/audit-logs.md) · operation `listAuditLogs`

Lists the workspace's audit log, newest first, as far back as the plan keeps audit logs: what changed, who changed it and in which project. The changed values are available from getAuditLog. Requires the workspace's logs view permission.

## Parameters

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `filter` | query | no |  | Filters and sorts the list: URL-encoded JSON of the schema `AuditLogFilter`. `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. `sor… |
| `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/audit-logs \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

## Responses

- `200`: The audit log entries.
- `400`: 
- `401`: 
- `403`: 
- `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": "Audit Logs",
      "description": "Read the workspace's audit log: who changed what, and when."
    }
  ],
  "paths": {
    "/v2/audit-logs": {
      "get": {
        "tags": [
          "Audit Logs"
        ],
        "summary": "List workspace audit logs",
        "description": "Lists the workspace's audit log, newest first, as far back as the plan keeps audit logs: what changed, who changed it and in which project. The changed values are available from getAuditLog. Requires the workspace's logs view permission.",
        "operationId": "listAuditLogs",
        "parameters": [
          {
            "name": "filter",
            "in": "query",
            "description": "Filters and sorts the list: URL-encoded JSON of the schema `AuditLogFilter`. `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| `audit_log[actor_id]` | id | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[actor_type]` | LINGOHUB_ROBOT \\| USER \\| API_KEY \\| LINA | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[category]` | WORKSPACES \\| TMS \\| MARKETPLACE \\| API \\| MEMBERS \\| LABELS \\| PROJECTS \\| USERS | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[created_at]` | timestamp | `_eq` `_lt` `_gt` `_lte` `_gte` `_within` `_null` `_nnull` | yes |\n| `audit_log[event]` | CREATE \\| UPDATE \\| DELETE \\| RENAME \\| IMPORT \\| EXPORT \\| DEACTIVATE \\| ACTIVATE \\| CANCEL \\| RENEW \\| APPROVE \\| FAIL \\| ACCEPT \\| DECLINE \\| TRANSFER \\| RESET \\| CONFIRM \\| ENABLE \\| DISABLE \\| SCHEDULE | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[id]` | id | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[project_id]` | id | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[project_name]` | text | `_eq` `_ne` `_like` `_nlike` `_ilike` `_nilike` `_contains` `_ncontains` `_icontains` `_nicontains` `_starts` `_ends` `_blank` `_nblank` | – |\n| `audit_log[request_id]` | uuid | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[target]` | GENERAL \\| PROFILE \\| PROFILE_URL \\| SUBSCRIPTION \\| BILLING_INFOS \\| PAYMENT_INFOS \\| INVOICES \\| PAYMENTS \\| GLOSSARIES \\| TRANSLATION_MEMORIES \\| STYLE_GUIDES \\| ORDERS \\| KEYS \\| WEBHOOKS \\| INVITATION \\| PERMISSION \\| ROLE \\| LOCALES \\| RESOURCES \\| PACKAGES \\| BACKUPS \\| PRE_TRANSLATION \\| INTEGRATIONS \\| API_LOGS \\| STACK \\| LINA \\| AUDIT_LOGS \\| SEGMENT_TEXT_EDITS \\| WORK_LOGS \\| PASSWORD \\| WORKSPACE \\| TWO_FACTOR \\| TEXT_PROCESSINGS \\| SETTINGS \\| BRANCHES | `_eq` `_ne` `_in` `_nin` | – |\n| `audit_log[updated_at]` | timestamp | `_eq` `_lt` `_gt` `_lte` `_gte` `_within` `_null` `_nnull` | yes |\n",
            "required": false,
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditLogFilter"
                }
              }
            }
          },
          {
            "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 audit log entries.",
            "headers": {
              "RateLimit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditLogCollection"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AuditLogFilter": {
        "type": "object",
        "additionalProperties": false,
        "description": "The filter of a list: which items to return and in which order.",
        "properties": {
          "where": {
            "$ref": "#/components/schemas/AuditLogFilterGroup"
          },
          "sort": {
            "type": "array",
            "description": "Fields to sort by, in order: `+` ascending, `-` descending.",
            "items": {
              "type": "string",
              "enum": [
                "+audit_log[created_at]",
                "-audit_log[created_at]",
                "+audit_log[updated_at]",
                "-audit_log[updated_at]"
              ]
            },
            "maxItems": 8
          }
        }
      },
      "AuditLogFilterGroup": {
        "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/AuditLogFilterClause"
            },
            "minItems": 1
          },
          "_or": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AuditLogFilterClause"
            },
            "minItems": 1
          }
        }
      },
      "AuditLogFilterClause": {
        "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/AuditLogFilterClause"
            },
            "minItems": 1
          },
          "_or": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AuditLogFilterClause"
            },
            "minItems": 1
          },
          "audit_log[actor_id]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "pattern": "^act_[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": "^act_[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": "^act_[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": "^act_[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
              }
            }
          },
          "audit_log[actor_type]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "enum": [
                  "LINGOHUB_ROBOT",
                  "USER",
                  "API_KEY",
                  "LINA"
                ]
              },
              "_ne": {
                "type": "string",
                "enum": [
                  "LINGOHUB_ROBOT",
                  "USER",
                  "API_KEY",
                  "LINA"
                ]
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "LINGOHUB_ROBOT",
                    "USER",
                    "API_KEY",
                    "LINA"
                  ]
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "LINGOHUB_ROBOT",
                    "USER",
                    "API_KEY",
                    "LINA"
                  ]
                },
                "minItems": 1
              }
            }
          },
          "audit_log[category]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "enum": [
                  "WORKSPACES",
                  "TMS",
                  "MARKETPLACE",
                  "API",
                  "MEMBERS",
                  "LABELS",
                  "PROJECTS",
                  "USERS"
                ]
              },
              "_ne": {
                "type": "string",
                "enum": [
                  "WORKSPACES",
                  "TMS",
                  "MARKETPLACE",
                  "API",
                  "MEMBERS",
                  "LABELS",
                  "PROJECTS",
                  "USERS"
                ]
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "WORKSPACES",
                    "TMS",
                    "MARKETPLACE",
                    "API",
                    "MEMBERS",
                    "LABELS",
                    "PROJECTS",
                    "USERS"
                  ]
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "WORKSPACES",
                    "TMS",
                    "MARKETPLACE",
                    "API",
                    "MEMBERS",
                    "LABELS",
                    "PROJECTS",
                    "USERS"
                  ]
                },
                "minItems": 1
              }
            }
          },
          "audit_log[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
                ]
              }
            }
          },
          "audit_log[event]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "enum": [
                  "CREATE",
                  "UPDATE",
                  "DELETE",
                  "RENAME",
                  "IMPORT",
                  "EXPORT",
                  "DEACTIVATE",
                  "ACTIVATE",
                  "CANCEL",
                  "RENEW",
                  "APPROVE",
                  "FAIL",
                  "ACCEPT",
                  "DECLINE",
                  "TRANSFER",
                  "RESET",
                  "CONFIRM",
                  "ENABLE",
                  "DISABLE",
                  "SCHEDULE"
                ]
              },
              "_ne": {
                "type": "string",
                "enum": [
                  "CREATE",
                  "UPDATE",
                  "DELETE",
                  "RENAME",
                  "IMPORT",
                  "EXPORT",
                  "DEACTIVATE",
                  "ACTIVATE",
                  "CANCEL",
                  "RENEW",
                  "APPROVE",
                  "FAIL",
                  "ACCEPT",
                  "DECLINE",
                  "TRANSFER",
                  "RESET",
                  "CONFIRM",
                  "ENABLE",
                  "DISABLE",
                  "SCHEDULE"
                ]
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "CREATE",
                    "UPDATE",
                    "DELETE",
                    "RENAME",
                    "IMPORT",
                    "EXPORT",
                    "DEACTIVATE",
                    "ACTIVATE",
                    "CANCEL",
                    "RENEW",
                    "APPROVE",
                    "FAIL",
                    "ACCEPT",
                    "DECLINE",
                    "TRANSFER",
                    "RESET",
                    "CONFIRM",
                    "ENABLE",
                    "DISABLE",
                    "SCHEDULE"
                  ]
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "CREATE",
                    "UPDATE",
                    "DELETE",
                    "RENAME",
                    "IMPORT",
                    "EXPORT",
                    "DEACTIVATE",
                    "ACTIVATE",
                    "CANCEL",
                    "RENEW",
                    "APPROVE",
                    "FAIL",
                    "ACCEPT",
                    "DECLINE",
                    "TRANSFER",
                    "RESET",
                    "CONFIRM",
                    "ENABLE",
                    "DISABLE",
                    "SCHEDULE"
                  ]
                },
                "minItems": 1
              }
            }
          },
          "audit_log[id]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "pattern": "^audit_[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": "^audit_[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": "^audit_[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": "^audit_[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
              }
            }
          },
          "audit_log[project_id]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "pattern": "^pr_[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": "^pr_[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": "^pr_[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": "^pr_[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
              }
            }
          },
          "audit_log[project_name]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string"
              },
              "_ne": {
                "type": "string"
              },
              "_like": {
                "type": "string"
              },
              "_nlike": {
                "type": "string"
              },
              "_ilike": {
                "type": "string"
              },
              "_nilike": {
                "type": "string"
              },
              "_contains": {
                "type": "string"
              },
              "_ncontains": {
                "type": "string"
              },
              "_icontains": {
                "type": "string"
              },
              "_nicontains": {
                "type": "string"
              },
              "_starts": {
                "type": "string"
              },
              "_ends": {
                "type": "string"
              },
              "_blank": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              },
              "_nblank": {
                "type": "boolean",
                "description": "Takes no value; send `true`.",
                "enum": [
                  true
                ]
              }
            }
          },
          "audit_log[request_id]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "format": "uuid"
              },
              "_ne": {
                "type": "string",
                "format": "uuid"
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "minItems": 1
              }
            }
          },
          "audit_log[target]": {
            "type": "object",
            "additionalProperties": false,
            "description": "Exactly one operator of the field.",
            "maxProperties": 1,
            "minProperties": 1,
            "properties": {
              "_eq": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "PROFILE",
                  "PROFILE_URL",
                  "SUBSCRIPTION",
                  "BILLING_INFOS",
                  "PAYMENT_INFOS",
                  "INVOICES",
                  "PAYMENTS",
                  "GLOSSARIES",
                  "TRANSLATION_MEMORIES",
                  "STYLE_GUIDES",
                  "ORDERS",
                  "KEYS",
                  "WEBHOOKS",
                  "INVITATION",
                  "PERMISSION",
                  "ROLE",
                  "LOCALES",
                  "RESOURCES",
                  "PACKAGES",
                  "BACKUPS",
                  "PRE_TRANSLATION",
                  "INTEGRATIONS",
                  "API_LOGS",
                  "STACK",
                  "LINA",
                  "AUDIT_LOGS",
                  "SEGMENT_TEXT_EDITS",
                  "WORK_LOGS",
                  "PASSWORD",
                  "WORKSPACE",
                  "TWO_FACTOR",
                  "TEXT_PROCESSINGS",
                  "SETTINGS",
                  "BRANCHES"
                ]
              },
              "_ne": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "PROFILE",
                  "PROFILE_URL",
                  "SUBSCRIPTION",
                  "BILLING_INFOS",
                  "PAYMENT_INFOS",
                  "INVOICES",
                  "PAYMENTS",
                  "GLOSSARIES",
                  "TRANSLATION_MEMORIES",
                  "STYLE_GUIDES",
                  "ORDERS",
                  "KEYS",
                  "WEBHOOKS",
                  "INVITATION",
                  "PERMISSION",
                  "ROLE",
                  "LOCALES",
                  "RESOURCES",
                  "PACKAGES",
                  "BACKUPS",
                  "PRE_TRANSLATION",
                  "INTEGRATIONS",
                  "API_LOGS",
                  "STACK",
                  "LINA",
                  "AUDIT_LOGS",
                  "SEGMENT_TEXT_EDITS",
                  "WORK_LOGS",
                  "PASSWORD",
                  "WORKSPACE",
                  "TWO_FACTOR",
                  "TEXT_PROCESSINGS",
                  "SETTINGS",
                  "BRANCHES"
                ]
              },
              "_in": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "GENERAL",
                    "PROFILE",
                    "PROFILE_URL",
                    "SUBSCRIPTION",
                    "BILLING_INFOS",
                    "PAYMENT_INFOS",
                    "INVOICES",
                    "PAYMENTS",
                    "GLOSSARIES",
                    "TRANSLATION_MEMORIES",
                    "STYLE_GUIDES",
                    "ORDERS",
                    "KEYS",
                    "WEBHOOKS",
                    "INVITATION",
                    "PERMISSION",
                    "ROLE",
                    "LOCALES",
                    "RESOURCES",
                    "PACKAGES",
                    "BACKUPS",
                    "PRE_TRANSLATION",
                    "INTEGRATIONS",
                    "API_LOGS",
                    "STACK",
                    "LINA",
                    "AUDIT_LOGS",
                    "SEGMENT_TEXT_EDITS",
                    "WORK_LOGS",
                    "PASSWORD",
                    "WORKSPACE",
                    "TWO_FACTOR",
                    "TEXT_PROCESSINGS",
                    "SETTINGS",
                    "BRANCHES"
                  ]
                },
                "minItems": 1
              },
              "_nin": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "GENERAL",
                    "PROFILE",
                    "PROFILE_URL",
                    "SUBSCRIPTION",
                    "BILLING_INFOS",
                    "PAYMENT_INFOS",
                    "INVOICES",
                    "PAYMENTS",
                    "GLOSSARIES",
                    "TRANSLATION_MEMORIES",
                    "STYLE_GUIDES",
                    "ORDERS",
                    "KEYS",
                    "WEBHOOKS",
                    "INVITATION",
                    "PERMISSION",
                    "ROLE",
                    "LOCALES",
                    "RESOURCES",
                    "PACKAGES",
                    "BACKUPS",
                    "PRE_TRANSLATION",
                    "INTEGRATIONS",
                    "API_LOGS",
                    "STACK",
                    "LINA",
                    "AUDIT_LOGS",
                    "SEGMENT_TEXT_EDITS",
                    "WORK_LOGS",
                    "PASSWORD",
                    "WORKSPACE",
                    "TWO_FACTOR",
                    "TEXT_PROCESSINGS",
                    "SETTINGS",
                    "BRANCHES"
                  ]
                },
                "minItems": 1
              }
            }
          },
          "audit_log[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
                ]
              }
            }
          }
        }
      },
      "AuditLogCollection": {
        "type": "object",
        "description": "A cursor-paginated collection of workspace audit logs.",
        "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": "AUDIT_LOG",
                "id": "audit_0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "request_id": "0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "category": "PROJECTS",
                "target": "GENERAL",
                "event": "UPDATE",
                "actor_id": "act_0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "actor_type": "API_KEY",
                "actor_name": "CI deployment key",
                "project_id": "pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
                "project_name": "Website",
                "created_at": "2025-01-15T10:30:00.123Z",
                "updated_at": "2025-01-15T10:30:00.123Z"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/AuditLog"
            }
          }
        },
        "required": [
          "data",
          "has_more",
          "next_cursor",
          "object_type"
        ]
      },
      "AuditLog": {
        "type": "object",
        "description": "One change in the workspace's audit log: what changed, who changed it and in which project. The changed values are returned by getAuditLog.",
        "properties": {
          "object_type": {
            "type": "string",
            "description": "Always `AUDIT_LOG`.",
            "enum": [
              "AUDIT_LOG"
            ],
            "example": "AUDIT_LOG"
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the audit log entry.",
            "example": "audit_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "minLength": 1,
            "pattern": "^audit_[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}$"
          },
          "request_id": {
            "type": "string",
            "format": "uuid",
            "description": "Id of the request that made the change, as V2 problem details and the X-Request-ID response header carry it; the API log entries of an API request have the same request_id.",
            "example": "0197c8f2-5a6b-7cde-8f12-3456789abcde"
          },
          "category": {
            "$ref": "#/components/schemas/AuditLogCategory",
            "description": "Area of the change.",
            "example": "PROJECTS"
          },
          "target": {
            "$ref": "#/components/schemas/AuditLogTarget",
            "description": "What was changed.",
            "example": "GENERAL"
          },
          "event": {
            "$ref": "#/components/schemas/AuditLogEvent",
            "description": "Kind of change.",
            "example": "UPDATE"
          },
          "actor_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The actor who made the change: the permanent identity of a user, API key, LINA or LingoHub itself. It stays the same after a member is removed from the workspace or a user, API key or LINA is deleted. Null only for entries without an actor.",
            "example": "act_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "pattern": "^act_[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}$"
          },
          "actor_type": {
            "description": "What kind of actor made the change; null only for entries without an actor.",
            "example": "API_KEY",
            "oneOf": [
              {
                "$ref": "#/components/schemas/AuditActorType"
              },
              {
                "type": "null"
              }
            ]
          },
          "actor_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current name of who made the change; a deleted user, API key or LINA is named \"Deleted User\", \"Deleted API Key\" or \"Deleted LINA\". Null only for entries without an actor.",
            "example": "CI deployment key"
          },
          "project_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The project the change was made in; null when there is none or it was deleted.",
            "example": "pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
            "pattern": "^pr_[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}$"
          },
          "project_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the project when the change was made; kept after the project is deleted.",
            "example": "Website"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the change was made.",
            "example": "2025-01-15T10:30:00.123Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the audit log entry was last changed.",
            "example": "2025-01-15T10:30:00.123Z"
          }
        },
        "required": [
          "actor_id",
          "actor_name",
          "actor_type",
          "category",
          "created_at",
          "event",
          "id",
          "object_type",
          "project_id",
          "project_name",
          "request_id",
          "target",
          "updated_at"
        ]
      },
      "AuditLogCategory": {
        "type": "string",
        "description": "Public audit log category.",
        "enum": [
          "WORKSPACES",
          "TMS",
          "MARKETPLACE",
          "API",
          "MEMBERS",
          "LABELS",
          "PROJECTS",
          "USERS"
        ]
      },
      "AuditLogTarget": {
        "type": "string",
        "description": "Public audit log target.",
        "enum": [
          "GENERAL",
          "PROFILE",
          "PROFILE_URL",
          "SUBSCRIPTION",
          "BILLING_INFOS",
          "PAYMENT_INFOS",
          "INVOICES",
          "PAYMENTS",
          "GLOSSARIES",
          "TRANSLATION_MEMORIES",
          "STYLE_GUIDES",
          "ORDERS",
          "KEYS",
          "WEBHOOKS",
          "INVITATION",
          "PERMISSION",
          "ROLE",
          "LOCALES",
          "RESOURCES",
          "PACKAGES",
          "BACKUPS",
          "PRE_TRANSLATION",
          "INTEGRATIONS",
          "API_LOGS",
          "STACK",
          "LINA",
          "AUDIT_LOGS",
          "SEGMENT_TEXT_EDITS",
          "WORK_LOGS",
          "PASSWORD",
          "WORKSPACE",
          "TWO_FACTOR",
          "TEXT_PROCESSINGS",
          "SETTINGS",
          "BRANCHES"
        ]
      },
      "AuditLogEvent": {
        "type": "string",
        "description": "Public audit log event.",
        "enum": [
          "CREATE",
          "UPDATE",
          "DELETE",
          "RENAME",
          "IMPORT",
          "EXPORT",
          "DEACTIVATE",
          "ACTIVATE",
          "CANCEL",
          "RENEW",
          "APPROVE",
          "FAIL",
          "ACCEPT",
          "DECLINE",
          "TRANSFER",
          "RESET",
          "CONFIRM",
          "ENABLE",
          "DISABLE",
          "SCHEDULE"
        ]
      },
      "AuditActorType": {
        "type": "string",
        "description": "Kind of permanent audit actor.",
        "enum": [
          "LINGOHUB_ROBOT",
          "USER",
          "API_KEY",
          "LINA"
        ]
      },
      "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"
            }
          }
        }
      },
      "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"
      }
    }
  }
}
````
