# LingoHub API V2 (Beta)

> **Beta:** API V2 is in beta. Endpoints, request and response fields, and behavior can still change. Use the LingoHub CLI (`lingohub`) where possible: it is updated together with the API. If you call the HTTP API directly, be prepared to update your integration when V2 changes.

The LingoHub V2 API provides programmatic access to your localization workflow. Use it to manage workspaces, projects, resources, translations, and more.

Base URL: `https://api.lingohub.com`. OpenAPI spec (OpenAPI 3.1.0, JSON): https://api.lingohub.com/public/api-docs/v2

Each operation below links to its page: parameters, an example request, the responses and its complete OpenAPI definition.

## Workspace

### [Workspaces](https://developers.lingohub.com/reference/v2/operations/tags/workspaces.md)

Read the workspace your API key belongs to. A workspace holds your stacks, projects and members.

- [`GET /v2/workspace`](https://developers.lingohub.com/reference/v2/operations/getworkspace.md): Retrieve the workspace

### [Members](https://developers.lingohub.com/reference/v2/operations/tags/members.md)

List, update and remove the members of the workspace.

- [`GET /v2/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/getmember.md): Retrieve a workspace member
- [`DELETE /v2/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/deletemember.md): Remove a workspace member
- [`PATCH /v2/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/updatemember.md): Update a workspace member
- [`GET /v2/members`](https://developers.lingohub.com/reference/v2/operations/listmembers.md): List workspace members

### [Invitations](https://developers.lingohub.com/reference/v2/operations/tags/invitations.md)

Invite people to the workspace by email, and manage pending invitations and the stacks they will join.

- [`GET /v2/invitations/{invitationId}/stack-assignment`](https://developers.lingohub.com/reference/v2/operations/getinvitationstackassignment.md): Retrieve invitation stack assignment
- [`PUT /v2/invitations/{invitationId}/stack-assignment`](https://developers.lingohub.com/reference/v2/operations/setinvitationstackassignment.md): Replace invitation stack assignment
- [`DELETE /v2/invitations/{invitationId}/stack-assignment`](https://developers.lingohub.com/reference/v2/operations/deleteinvitationstackassignment.md): Remove invitation stack assignment
- [`GET /v2/invitations`](https://developers.lingohub.com/reference/v2/operations/listinvitations.md): List email invitations
- [`POST /v2/invitations`](https://developers.lingohub.com/reference/v2/operations/createinvitation.md): Create an email invitation
- [`POST /v2/invitations/{invitationId}/resend`](https://developers.lingohub.com/reference/v2/operations/resendinvitation.md): Resend an email invitation
- [`GET /v2/invitations/{invitationId}`](https://developers.lingohub.com/reference/v2/operations/getinvitation.md): Retrieve an email invitation
- [`DELETE /v2/invitations/{invitationId}`](https://developers.lingohub.com/reference/v2/operations/deleteinvitation.md): Remove an email invitation

### [Workspace Roles](https://developers.lingohub.com/reference/v2/operations/tags/workspace-roles.md)

Read the roles a workspace member can have.

- [`GET /v2/workspace-roles`](https://developers.lingohub.com/reference/v2/operations/listworkspaceroles.md): List workspace roles
- [`GET /v2/workspace-roles/{workspaceRoleId}`](https://developers.lingohub.com/reference/v2/operations/getworkspacerole.md): Retrieve a workspace role

### [API Keys](https://developers.lingohub.com/reference/v2/operations/tags/api-keys.md)

Check the API key a request is made with, and read and rename the workspace's API keys.

- [`GET /v2/api-keys/{apiKeyId}`](https://developers.lingohub.com/reference/v2/operations/getworkspaceapikey.md): Retrieve a workspace API key
- [`PATCH /v2/api-keys/{apiKeyId}`](https://developers.lingohub.com/reference/v2/operations/updateworkspaceapikey.md): Update a workspace API key
- [`GET /v2/api-keys`](https://developers.lingohub.com/reference/v2/operations/listworkspaceapikeys.md): List workspace API keys
- [`GET /v2/api-key`](https://developers.lingohub.com/reference/v2/operations/getapikey.md): Retrieve the API key
- [`DELETE /v2/api-key`](https://developers.lingohub.com/reference/v2/operations/deleteapikey.md): Revoke the API key

### [Capabilities](https://developers.lingohub.com/reference/v2/operations/tags/capabilities.md)

Read the file formats a project uses and the largest file it imports.

- [`GET /v2/projects/{projectId}/capabilities`](https://developers.lingohub.com/reference/v2/operations/getprojectcapabilities.md): Retrieve project capabilities

### [Locales](https://developers.lingohub.com/reference/v2/operations/tags/locales.md)

List every locale LingoHub supports, to find the language codes you can add to a project or stack.

- [`GET /v2/locales`](https://developers.lingohub.com/reference/v2/operations/listlocales.md): List locales

## Stacks

### [Stacks](https://developers.lingohub.com/reference/v2/operations/tags/stacks.md)

Manage stacks. A stack holds the languages, members and texts its projects share: a `PUBLIC` stack can serve several projects, a `PRIVATE` stack belongs to one project.

- [`GET /v2/stacks/{stackId}/automation-settings`](https://developers.lingohub.com/reference/v2/operations/getstackautomationsettings.md): Retrieve stack automation settings
- [`PUT /v2/stacks/{stackId}/automation-settings`](https://developers.lingohub.com/reference/v2/operations/setstackautomationsettings.md): Replace stack automation settings
- [`GET /v2/stacks`](https://developers.lingohub.com/reference/v2/operations/liststacks.md): List stacks
- [`POST /v2/stacks`](https://developers.lingohub.com/reference/v2/operations/createstack.md): Create a stack
- [`GET /v2/stacks/{stackId}`](https://developers.lingohub.com/reference/v2/operations/getstack.md): Retrieve a stack
- [`DELETE /v2/stacks/{stackId}`](https://developers.lingohub.com/reference/v2/operations/deletestack.md): Delete a stack
- [`PATCH /v2/stacks/{stackId}`](https://developers.lingohub.com/reference/v2/operations/updatestack.md): Update a stack

### [Stack Members](https://developers.lingohub.com/reference/v2/operations/tags/stack-members.md)

Manage who has explicit access to a stack, with which role and language permissions.

- [`GET /v2/stacks/{stackId}/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/getstackmember.md): Retrieve an explicit stack member
- [`PUT /v2/stacks/{stackId}/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/setstackmember.md): Set an explicit stack member
- [`DELETE /v2/stacks/{stackId}/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/deletestackmember.md): Remove an explicit stack member
- [`PATCH /v2/stacks/{stackId}/members/{memberId}`](https://developers.lingohub.com/reference/v2/operations/updatestackmember.md): Update an explicit stack member
- [`GET /v2/stacks/{stackId}/members`](https://developers.lingohub.com/reference/v2/operations/liststackmembers.md): List explicit stack members

### [Stack Member Permissions](https://developers.lingohub.com/reference/v2/operations/tags/stack-member-permissions.md)

Read the permissions a member effectively has in a stack.

- [`GET /v2/stacks/{stackId}/member-permissions/{memberId}`](https://developers.lingohub.com/reference/v2/operations/getstackmemberpermissions.md): Retrieve effective stack member permissions

### [Stack Roles](https://developers.lingohub.com/reference/v2/operations/tags/stack-roles.md)

Read the roles a stack member can have.

- [`GET /v2/stack-roles`](https://developers.lingohub.com/reference/v2/operations/liststackroles.md): List stack roles
- [`GET /v2/stack-roles/{stackRoleId}`](https://developers.lingohub.com/reference/v2/operations/getstackrole.md): Retrieve a stack role

### [Stack Languages](https://developers.lingohub.com/reference/v2/operations/tags/stack-languages.md)

Manage the target languages configured for a stack. The stack's languages are shared by every project assigned to that stack.

- [`GET /v2/stacks/{stackId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/getstacklanguage.md): Retrieve a stack language
- [`PUT /v2/stacks/{stackId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/addstacklanguage.md): Add a stack language
- [`DELETE /v2/stacks/{stackId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/deletestacklanguage.md): Remove a stack language
- [`PATCH /v2/stacks/{stackId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/updatestacklanguage.md): Update a stack language
- [`GET /v2/stacks/{stackId}/languages`](https://developers.lingohub.com/reference/v2/operations/liststacklanguages.md): List stack languages

## Projects

### [Projects](https://developers.lingohub.com/reference/v2/operations/tags/projects.md)

Manage the localization projects of the workspace. A project holds resource files, languages and texts.

- [`GET /v2/projects`](https://developers.lingohub.com/reference/v2/operations/listprojects.md): List projects
- [`POST /v2/projects`](https://developers.lingohub.com/reference/v2/operations/createproject.md): Create a project
- [`GET /v2/projects/{projectId}`](https://developers.lingohub.com/reference/v2/operations/getproject.md): Retrieve a project
- [`DELETE /v2/projects/{projectId}`](https://developers.lingohub.com/reference/v2/operations/deleteproject.md): Delete a project
- [`PATCH /v2/projects/{projectId}`](https://developers.lingohub.com/reference/v2/operations/updateproject.md): Update a project

### [Project Settings](https://developers.lingohub.com/reference/v2/operations/tags/project-settings.md)

Read and change a project's settings: export and import defaults, file-format options, key normalisation, placeholder recognition and integration settings.

- [`GET /v2/projects/{projectId}/settings`](https://developers.lingohub.com/reference/v2/operations/getprojectsettings.md): Retrieve project settings
- [`PATCH /v2/projects/{projectId}/settings`](https://developers.lingohub.com/reference/v2/operations/updateprojectsettings.md): Update project settings

### [Project Languages](https://developers.lingohub.com/reference/v2/operations/tags/project-languages.md)

Manage the target languages configured for a project. Project languages are scoped to a branch.

- [`GET /v2/branches/{branchId}/languages`](https://developers.lingohub.com/reference/v2/operations/listprojectlanguages.md): List project languages
- [`POST /v2/branches/{branchId}/languages`](https://developers.lingohub.com/reference/v2/operations/addprojectlanguages.md): Add project languages
- [`GET /v2/branches/{branchId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/getprojectlanguage.md): Retrieve a project language
- [`DELETE /v2/branches/{branchId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/deleteprojectlanguage.md): Remove a project language
- [`PATCH /v2/branches/{branchId}/languages/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/updateprojectlanguage.md): Update a project language

### [Project Moves](https://developers.lingohub.com/reference/v2/operations/tags/project-moves.md)

Move a project to another stack, or detach it into a stack of its own, as an async job.

- [`POST /v2/projects/{projectId}/move`](https://developers.lingohub.com/reference/v2/operations/moveproject.md): Move a project
- [`POST /v2/projects/{projectId}/detach`](https://developers.lingohub.com/reference/v2/operations/detachproject.md): Detach a project
- [`GET /v2/project-moves/{projectMoveId}`](https://developers.lingohub.com/reference/v2/operations/getprojectmove.md): Retrieve a project move

### [Branches](https://developers.lingohub.com/reference/v2/operations/tags/branches.md)

Manage branches within a project. Branches isolate translation work; each project has exactly one default branch that cannot be deleted.

- [`GET /v2/projects/{projectId}/branches`](https://developers.lingohub.com/reference/v2/operations/listbranches.md): List branches
- [`POST /v2/projects/{projectId}/branches`](https://developers.lingohub.com/reference/v2/operations/createbranch.md): Create a branch
- [`POST /v2/branches/{branchId}/set-default`](https://developers.lingohub.com/reference/v2/operations/setdefaultbranch.md): Set the default branch
- [`GET /v2/branches/{branchId}`](https://developers.lingohub.com/reference/v2/operations/getbranch.md): Retrieve a branch
- [`DELETE /v2/branches/{branchId}`](https://developers.lingohub.com/reference/v2/operations/deletebranch.md): Delete a branch
- [`PATCH /v2/branches/{branchId}`](https://developers.lingohub.com/reference/v2/operations/updatebranch.md): Rename a branch

## Files and texts

### [Resources](https://developers.lingohub.com/reference/v2/operations/tags/resources.md)

List and manage the resource files of a project branch, with their format, path and translation status per language.

- [`GET /v2/branches/{branchId}/resources`](https://developers.lingohub.com/reference/v2/operations/listresources.md): List resources
- [`POST /v2/branches/{branchId}/resources`](https://developers.lingohub.com/reference/v2/operations/createresource.md): Create a resource
- [`GET /v2/resources/{resourceId}`](https://developers.lingohub.com/reference/v2/operations/getresource.md): Retrieve a resource
- [`DELETE /v2/resources/{resourceId}`](https://developers.lingohub.com/reference/v2/operations/deleteresource.md): Delete a resource
- [`PATCH /v2/resources/{resourceId}`](https://developers.lingohub.com/reference/v2/operations/updateresource.md): Update a resource

### [Imports](https://developers.lingohub.com/reference/v2/operations/tags/imports.md)

Import files into a branch in the background, and see what each import changed.

- [`GET /v2/branches/{branchId}/imports`](https://developers.lingohub.com/reference/v2/operations/listimports.md): List imports
- [`POST /v2/branches/{branchId}/imports`](https://developers.lingohub.com/reference/v2/operations/createimport.md): Create an import
- [`GET /v2/imports/{importId}`](https://developers.lingohub.com/reference/v2/operations/getimport.md): Retrieve an import
- [`GET /v2/imports/{importId}/logs`](https://developers.lingohub.com/reference/v2/operations/listimportlogs.md): List import logs
- [`GET /v2/imports/{importId}/entries`](https://developers.lingohub.com/reference/v2/operations/listimportentries.md): List import entries
- [`GET /v2/imports/{importId}/changes`](https://developers.lingohub.com/reference/v2/operations/listimportchanges.md): List import changes
- [`GET /v2/import-entries/{importEntryId}`](https://developers.lingohub.com/reference/v2/operations/getimportentry.md): Retrieve an import entry

### [Exports](https://developers.lingohub.com/reference/v2/operations/tags/exports.md)

Export the files of a branch in the background and download them.

- [`GET /v2/branches/{branchId}/exports`](https://developers.lingohub.com/reference/v2/operations/listexports.md): List exports
- [`POST /v2/branches/{branchId}/exports`](https://developers.lingohub.com/reference/v2/operations/createexport.md): Create an export
- [`GET /v2/exports/{exportId}`](https://developers.lingohub.com/reference/v2/operations/getexport.md): Retrieve an export
- [`GET /v2/exports/{exportId}/logs`](https://developers.lingohub.com/reference/v2/operations/listexportlogs.md): List export logs
- [`GET /v2/exports/{exportId}/entries`](https://developers.lingohub.com/reference/v2/operations/listexportentries.md): List export entries
- [`GET /v2/export-entries/{exportEntryId}`](https://developers.lingohub.com/reference/v2/operations/getexportentry.md): Retrieve an export entry

### [Keys](https://developers.lingohub.com/reference/v2/operations/tags/keys.md)

List and manage the keys of a file. A key is where a segment appears in a file; the segment holds its texts.

- [`GET /v2/resources/{resourceId}/keys`](https://developers.lingohub.com/reference/v2/operations/listkeys.md): List keys
- [`POST /v2/resources/{resourceId}/keys`](https://developers.lingohub.com/reference/v2/operations/createkey.md): Create a key
- [`POST /v2/resources/{resourceId}/keys/bulk-create`](https://developers.lingohub.com/reference/v2/operations/createkeysbulk.md): Create keys in a batch
- [`GET /v2/keys/{keyId}`](https://developers.lingohub.com/reference/v2/operations/getkey.md): Retrieve a key
- [`DELETE /v2/keys/{keyId}`](https://developers.lingohub.com/reference/v2/operations/deletekey.md): Delete a key
- [`PATCH /v2/keys/{keyId}`](https://developers.lingohub.com/reference/v2/operations/updatekey.md): Update a key
- [`GET /v2/segments/{segmentId}/keys`](https://developers.lingohub.com/reference/v2/operations/listsegmentkeys.md): List segment keys

### [Segments](https://developers.lingohub.com/reference/v2/operations/tags/segments.md)

Read and change segments: a source text and its translations, which every key of the segment shows.

- [`POST /v2/segments/{segmentId}/transition`](https://developers.lingohub.com/reference/v2/operations/transitionsegment.md): Change the status of a text
- [`POST /v2/branches/{branchId}/segments/bulk-update`](https://developers.lingohub.com/reference/v2/operations/updatesegmentsbulk.md): Update segments in a batch
- [`POST /v2/branches/{branchId}/segments/bulk-transition`](https://developers.lingohub.com/reference/v2/operations/transitionsegmentsbulk.md): Change the statuses of texts in a batch
- [`GET /v2/segments/{segmentId}`](https://developers.lingohub.com/reference/v2/operations/getsegment.md): Retrieve a segment
- [`PATCH /v2/segments/{segmentId}`](https://developers.lingohub.com/reference/v2/operations/updatesegment.md): Update a segment
- [`GET /v2/branches/{branchId}/segments`](https://developers.lingohub.com/reference/v2/operations/listsegments.md): List segments

### [Labels](https://developers.lingohub.com/reference/v2/operations/tags/labels.md)

Manage the labels of the workspace. Labels tag segments, so you can categorize and filter content.

- [`GET /v2/labels`](https://developers.lingohub.com/reference/v2/operations/listlabels.md): List labels
- [`POST /v2/labels`](https://developers.lingohub.com/reference/v2/operations/createlabel.md): Create a label
- [`GET /v2/labels/{labelId}`](https://developers.lingohub.com/reference/v2/operations/getlabel.md): Retrieve a label
- [`DELETE /v2/labels/{labelId}`](https://developers.lingohub.com/reference/v2/operations/deletelabel.md): Delete a label
- [`PATCH /v2/labels/{labelId}`](https://developers.lingohub.com/reference/v2/operations/updatelabel.md): Update a label

### [Context Images](https://developers.lingohub.com/reference/v2/operations/tags/context-images.md)

Upload screenshots that show translators and LINAs where a text appears. An image belongs to one project language and can be attached to segments of that project.

- [`GET /v2/projects/{projectId}/context-images`](https://developers.lingohub.com/reference/v2/operations/listcontextimages.md): List context images
- [`POST /v2/projects/{projectId}/context-images`](https://developers.lingohub.com/reference/v2/operations/createcontextimage.md): Upload a context image
- [`POST /v2/context-images/{contextImageId}/detach`](https://developers.lingohub.com/reference/v2/operations/detachcontextimage.md): Detach a context image from segments
- [`POST /v2/context-images/{contextImageId}/attach`](https://developers.lingohub.com/reference/v2/operations/attachcontextimage.md): Attach a context image to segments
- [`GET /v2/context-images/{contextImageId}`](https://developers.lingohub.com/reference/v2/operations/getcontextimage.md): Retrieve a context image
- [`DELETE /v2/context-images/{contextImageId}`](https://developers.lingohub.com/reference/v2/operations/deletecontextimage.md): Delete a context image
- [`PATCH /v2/context-images/{contextImageId}`](https://developers.lingohub.com/reference/v2/operations/updatecontextimage.md): Update a context image

## Glossaries and style guides

### [Glossaries](https://developers.lingohub.com/reference/v2/operations/tags/glossaries.md)

Manage the workspace's glossaries: the terms LINA uses for translation and the terminology check.

- [`GET /v2/glossaries`](https://developers.lingohub.com/reference/v2/operations/listglossaries.md): List glossaries
- [`POST /v2/glossaries`](https://developers.lingohub.com/reference/v2/operations/createglossary.md): Create a glossary
- [`GET /v2/glossaries/{glossaryId}`](https://developers.lingohub.com/reference/v2/operations/getglossary.md): Retrieve a glossary
- [`DELETE /v2/glossaries/{glossaryId}`](https://developers.lingohub.com/reference/v2/operations/deleteglossary.md): Delete a glossary
- [`PATCH /v2/glossaries/{glossaryId}`](https://developers.lingohub.com/reference/v2/operations/updateglossary.md): Update a glossary

### [Terms](https://developers.lingohub.com/reference/v2/operations/tags/terms.md)

Manage the terms of a glossary. Per language, a term has one preferred form and any number of alternatives; a language without forms of its own can inherit another language's preferred form. Untranslatable terms have forms without a language.

- [`POST /v2/terms/{termId}/forms`](https://developers.lingohub.com/reference/v2/operations/createtermform.md): Add a term form
- [`GET /v2/glossaries/{glossaryId}/terms`](https://developers.lingohub.com/reference/v2/operations/listterms.md): List terms
- [`POST /v2/glossaries/{glossaryId}/terms`](https://developers.lingohub.com/reference/v2/operations/createterm.md): Create a term
- [`GET /v2/terms/{termId}`](https://developers.lingohub.com/reference/v2/operations/getterm.md): Retrieve a term
- [`DELETE /v2/terms/{termId}`](https://developers.lingohub.com/reference/v2/operations/deleteterm.md): Delete a term
- [`PATCH /v2/terms/{termId}`](https://developers.lingohub.com/reference/v2/operations/updateterm.md): Update a term
- [`GET /v2/term-forms/{termFormId}`](https://developers.lingohub.com/reference/v2/operations/gettermform.md): Retrieve a term form
- [`DELETE /v2/term-forms/{termFormId}`](https://developers.lingohub.com/reference/v2/operations/deletetermform.md): Delete a term form
- [`PATCH /v2/term-forms/{termFormId}`](https://developers.lingohub.com/reference/v2/operations/updatetermform.md): Update a term form

### [Style Guides](https://developers.lingohub.com/reference/v2/operations/tags/style-guides.md)

Manage style guides: the tone, audience and language rules that guide AI translation.

- [`GET /v2/style-guides`](https://developers.lingohub.com/reference/v2/operations/liststyleguides.md): List style guides
- [`POST /v2/style-guides`](https://developers.lingohub.com/reference/v2/operations/createstyleguide.md): Create a style guide
- [`GET /v2/style-guides/{styleGuideId}`](https://developers.lingohub.com/reference/v2/operations/getstyleguide.md): Retrieve a style guide
- [`DELETE /v2/style-guides/{styleGuideId}`](https://developers.lingohub.com/reference/v2/operations/deletestyleguide.md): Delete a style guide
- [`PATCH /v2/style-guides/{styleGuideId}`](https://developers.lingohub.com/reference/v2/operations/updatestyleguide.md): Update a style guide

### [Style Guide Language Rules](https://developers.lingohub.com/reference/v2/operations/tags/style-guide-language-rules.md)

Override a style guide's rules for a single language.

- [`GET /v2/style-guides/{styleGuideId}/rules/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/getstyleguidelanguagerules.md): Retrieve style guide language rules
- [`PUT /v2/style-guides/{styleGuideId}/rules/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/setstyleguidelanguagerules.md): Set style guide language rules
- [`DELETE /v2/style-guides/{styleGuideId}/rules/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/deletestyleguidelanguagerules.md): Delete style guide language rules

### [Style Guide Language Variants](https://developers.lingohub.com/reference/v2/operations/tags/style-guide-language-variants.md)

Map a language to its regional variant within a style guide, for example `en` to `en-US`. A language can have a variant without rules, and rules without a variant.

- [`GET /v2/style-guides/{styleGuideId}/language-variants/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/getstyleguidelanguagevariant.md): Retrieve a style guide language variant
- [`PUT /v2/style-guides/{styleGuideId}/language-variants/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/setstyleguidelanguagevariant.md): Set a style guide language variant
- [`DELETE /v2/style-guides/{styleGuideId}/language-variants/{languageCode}`](https://developers.lingohub.com/reference/v2/operations/deletestyleguidelanguagevariant.md): Delete a style guide language variant

## LINA and engines

### [LINAs](https://developers.lingohub.com/reference/v2/operations/tags/linas.md)

Manage LINAs, LingoHub's AI translation agents, and translate texts with them.

- [`GET /v2/linas`](https://developers.lingohub.com/reference/v2/operations/listlinas.md): List LINAs
- [`POST /v2/linas`](https://developers.lingohub.com/reference/v2/operations/createlina.md): Create a LINA
- [`POST /v2/linas/{linaId}/translate`](https://developers.lingohub.com/reference/v2/operations/translatelina.md): Translate plain texts with a LINA
- [`GET /v2/linas/{linaId}`](https://developers.lingohub.com/reference/v2/operations/getlina.md): Retrieve a LINA
- [`DELETE /v2/linas/{linaId}`](https://developers.lingohub.com/reference/v2/operations/deletelina.md): Delete a LINA
- [`PATCH /v2/linas/{linaId}`](https://developers.lingohub.com/reference/v2/operations/updatelina.md): Update a LINA
- [`GET /v2/linas/{linaId}/quality-check-settings`](https://developers.lingohub.com/reference/v2/operations/getlinaqualitychecksettings.md): Retrieve LINA quality settings
- [`PATCH /v2/linas/{linaId}/quality-check-settings`](https://developers.lingohub.com/reference/v2/operations/updatelinaqualitychecksettings.md): Update LINA quality settings

### [LINA Executions](https://developers.lingohub.com/reference/v2/operations/tags/lina-executions.md)

Pre-translate texts of a branch with the stack's LINA in the background, and follow the runs.

- [`GET /v2/branches/{branchId}/lina-executions`](https://developers.lingohub.com/reference/v2/operations/listlinaexecutions.md): List LINA runs
- [`POST /v2/branches/{branchId}/lina-executions`](https://developers.lingohub.com/reference/v2/operations/createlinaexecution.md): Pre-translate with LINA
- [`GET /v2/lina-executions/{linaExecutionId}`](https://developers.lingohub.com/reference/v2/operations/getlinaexecution.md): Retrieve a LINA run

### [Linguistic Engines](https://developers.lingohub.com/reference/v2/operations/tags/linguistic-engines.md)

Read the translation engines a LINA can use.

- [`GET /v2/linguistic-engines`](https://developers.lingohub.com/reference/v2/operations/listlinguisticengines.md): List linguistic engines
- [`GET /v2/linguistic-engines/{linguisticEngineId}`](https://developers.lingohub.com/reference/v2/operations/getlinguisticengine.md): Retrieve a linguistic engine

## Distributions

### [Distributions](https://developers.lingohub.com/reference/v2/operations/tags/distributions.md)

Read a project's distributions, which deliver its translations over the CDN.

- [`GET /v2/projects/{projectId}/distributions`](https://developers.lingohub.com/reference/v2/operations/listdistributions.md): List distributions
- [`GET /v2/distributions/{distributionId}`](https://developers.lingohub.com/reference/v2/operations/getdistribution.md): Retrieve a distribution

### [Distribution Releases](https://developers.lingohub.com/reference/v2/operations/tags/distribution-releases.md)

Read the releases of a distribution and download their archives.

- [`GET /v2/distributions/{distributionId}/releases`](https://developers.lingohub.com/reference/v2/operations/listdistributionreleases.md): List distribution releases
- [`GET /v2/distribution-releases/{distributionReleaseId}`](https://developers.lingohub.com/reference/v2/operations/getdistributionrelease.md): Retrieve a distribution release

## Backups

### [Backups](https://developers.lingohub.com/reference/v2/operations/tags/backups.md)

Back up branches of a project, list the backups and delete them.

- [`POST /v2/branches/{branchId}/backups`](https://developers.lingohub.com/reference/v2/operations/createbackup.md): Create a backup
- [`GET /v2/projects/{projectId}/backups`](https://developers.lingohub.com/reference/v2/operations/listbackups.md): List backups
- [`GET /v2/backups/{backupId}`](https://developers.lingohub.com/reference/v2/operations/getbackup.md): Retrieve a backup
- [`DELETE /v2/backups/{backupId}`](https://developers.lingohub.com/reference/v2/operations/deletebackup.md): Delete a backup

### [Backup Settings](https://developers.lingohub.com/reference/v2/operations/tags/backup-settings.md)

Schedule automatic backups of a project's branches.

- [`GET /v2/projects/{projectId}/backup-settings`](https://developers.lingohub.com/reference/v2/operations/getbackupsettings.md): Retrieve automatic backup settings
- [`PUT /v2/projects/{projectId}/backup-settings`](https://developers.lingohub.com/reference/v2/operations/setbackupsettings.md): Set automatic backup settings
- [`DELETE /v2/projects/{projectId}/backup-settings`](https://developers.lingohub.com/reference/v2/operations/deletebackupsettings.md): Delete automatic backup settings

### [Backup Restores](https://developers.lingohub.com/reference/v2/operations/tags/backup-restores.md)

Restore languages of a backup into a branch in the background, and follow the restore.

- [`POST /v2/branches/{branchId}/backup-restores`](https://developers.lingohub.com/reference/v2/operations/createbackuprestore.md): Create a backup restore
- [`GET /v2/backup-restores/{backupRestoreId}`](https://developers.lingohub.com/reference/v2/operations/getbackuprestore.md): Retrieve a backup restore

## Webhooks

### [Webhooks](https://developers.lingohub.com/reference/v2/operations/tags/webhooks.md)

Receive LingoHub events at your own endpoint: manage endpoints and signing secrets, and inspect or redeliver deliveries.

- [`GET /v2/webhook-endpoints`](https://developers.lingohub.com/reference/v2/operations/listwebhookendpoints.md): List webhook endpoints
- [`POST /v2/webhook-endpoints`](https://developers.lingohub.com/reference/v2/operations/createwebhookendpoint.md): Create a webhook endpoint
- [`POST /v2/webhook-endpoints/{webhookEndpointId}/test`](https://developers.lingohub.com/reference/v2/operations/testwebhookendpoint.md): Test a webhook endpoint
- [`POST /v2/webhook-endpoints/{webhookEndpointId}/rotate-secret`](https://developers.lingohub.com/reference/v2/operations/rotatewebhookendpointsecret.md): Rotate a webhook signing secret
- [`POST /v2/webhook-endpoints/{webhookEndpointId}/enable`](https://developers.lingohub.com/reference/v2/operations/enablewebhookendpoint.md): Enable a webhook endpoint
- [`POST /v2/webhook-endpoints/{webhookEndpointId}/disable`](https://developers.lingohub.com/reference/v2/operations/disablewebhookendpoint.md): Disable a webhook endpoint
- [`POST /v2/webhook-deliveries/{webhookDeliveryId}/redeliver`](https://developers.lingohub.com/reference/v2/operations/redeliverwebhookdelivery.md): Redeliver a webhook delivery
- [`GET /v2/webhook-endpoints/{webhookEndpointId}`](https://developers.lingohub.com/reference/v2/operations/getwebhookendpoint.md): Retrieve a webhook endpoint
- [`DELETE /v2/webhook-endpoints/{webhookEndpointId}`](https://developers.lingohub.com/reference/v2/operations/deletewebhookendpoint.md): Delete a webhook endpoint
- [`PATCH /v2/webhook-endpoints/{webhookEndpointId}`](https://developers.lingohub.com/reference/v2/operations/updatewebhookendpoint.md): Update a webhook endpoint
- [`GET /v2/webhook-event-types`](https://developers.lingohub.com/reference/v2/operations/listwebhookeventtypes.md): List webhook subscription event types
- [`GET /v2/webhook-endpoints/{webhookEndpointId}/deliveries`](https://developers.lingohub.com/reference/v2/operations/listwebhookdeliveries.md): List webhook deliveries
- [`GET /v2/webhook-deliveries/{webhookDeliveryId}`](https://developers.lingohub.com/reference/v2/operations/getwebhookdelivery.md): Retrieve a webhook delivery

## Git integrations

### [Git Integrations](https://developers.lingohub.com/reference/v2/operations/tags/git-integrations.md)

Connect a project to a Git repository and sync files with it as async jobs.

- [`GET /v2/projects/{projectId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/getprojectgitintegration.md): Retrieve the project's git integration
- [`POST /v2/projects/{projectId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/createprojectgitintegration.md): Connect a project to Git
- [`DELETE /v2/projects/{projectId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/deleteprojectgitintegration.md): Disconnect a project's Git integration
- [`PATCH /v2/projects/{projectId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/updateprojectgitintegration.md): Update the project's git integration
- [`GET /v2/branches/{branchId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/getbranchgitintegration.md): Retrieve the branch's git integration
- [`POST /v2/branches/{branchId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/createbranchgitintegration.md): Bind a project branch to Git
- [`DELETE /v2/branches/{branchId}/integrations/git`](https://developers.lingohub.com/reference/v2/operations/deletebranchgitintegration.md): Disconnect a project branch from Git
- [`POST /v2/branches/{branchId}/integrations/git/push`](https://developers.lingohub.com/reference/v2/operations/pushtogit.md): Push to git integration
- [`POST /v2/branches/{branchId}/integrations/git/pull`](https://developers.lingohub.com/reference/v2/operations/pullfromgit.md): Pull from git integration

### [Integration Authentications](https://developers.lingohub.com/reference/v2/operations/tags/integration-authentications.md)

Manage the stored credentials LingoHub uses to connect to Git providers and content platforms.

- [`PUT /v2/integration-authentications/{integrationAuthenticationId}/credentials`](https://developers.lingohub.com/reference/v2/operations/setintegrationauthenticationcredentials.md): Replace integration authentication credentials
- [`GET /v2/integration-authentications`](https://developers.lingohub.com/reference/v2/operations/listintegrationauthentications.md): List integration authentications
- [`POST /v2/integration-authentications`](https://developers.lingohub.com/reference/v2/operations/createintegrationauthentication.md): Create an integration authentication
- [`GET /v2/integration-authentications/{integrationAuthenticationId}`](https://developers.lingohub.com/reference/v2/operations/getintegrationauthentication.md): Retrieve an integration authentication
- [`DELETE /v2/integration-authentications/{integrationAuthenticationId}`](https://developers.lingohub.com/reference/v2/operations/deleteintegrationauthentication.md): Delete an integration authentication
- [`PATCH /v2/integration-authentications/{integrationAuthenticationId}`](https://developers.lingohub.com/reference/v2/operations/updateintegrationauthentication.md): Rename an integration authentication

### [GitHub Integrations](https://developers.lingohub.com/reference/v2/operations/tags/github-integrations.md)

Install the GitHub app, and list repositories, branches and folders for a Git integration.

- [`GET /v2/integrations/github/installation-link`](https://developers.lingohub.com/reference/v2/operations/getgithubinstallationlink.md): Retrieve the GitHub installation link
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/github-repositories`](https://developers.lingohub.com/reference/v2/operations/listgithubrepositories.md): List GitHub repositories
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/github-directory-entries`](https://developers.lingohub.com/reference/v2/operations/listgithubdirectoryentries.md): List GitHub directory entries
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/github-branches`](https://developers.lingohub.com/reference/v2/operations/listgithubbranches.md): List GitHub branches

### [GitLab Integrations](https://developers.lingohub.com/reference/v2/operations/tags/gitlab-integrations.md)

List GitLab repositories, branches and folders for a Git integration.

- [`GET /v2/integration-authentications/{integrationAuthenticationId}/gitlab-repositories`](https://developers.lingohub.com/reference/v2/operations/listgitlabrepositories.md): List GitLab repositories
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/gitlab-directory-entries`](https://developers.lingohub.com/reference/v2/operations/listgitlabdirectoryentries.md): List GitLab directory entries
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/gitlab-branches`](https://developers.lingohub.com/reference/v2/operations/listgitlabbranches.md): List GitLab branches

### [Bitbucket Integrations](https://developers.lingohub.com/reference/v2/operations/tags/bitbucket-integrations.md)

List Bitbucket workspaces, repositories, branches and folders for a Git integration.

- [`GET /v2/integration-authentications/{integrationAuthenticationId}/bitbucket-workspaces`](https://developers.lingohub.com/reference/v2/operations/listbitbucketworkspaces.md): List Bitbucket workspaces
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/bitbucket-repositories`](https://developers.lingohub.com/reference/v2/operations/listbitbucketrepositories.md): List Bitbucket repositories
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/bitbucket-directory-entries`](https://developers.lingohub.com/reference/v2/operations/listbitbucketdirectoryentries.md): List Bitbucket directory entries
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/bitbucket-branches`](https://developers.lingohub.com/reference/v2/operations/listbitbucketbranches.md): List Bitbucket branches

### [Azure Integrations](https://developers.lingohub.com/reference/v2/operations/tags/azure-integrations.md)

List Azure DevOps organizations, projects, repositories, branches and folders for a Git integration.

- [`GET /v2/integration-authentications/{integrationAuthenticationId}/azure-repositories`](https://developers.lingohub.com/reference/v2/operations/listazurerepositories.md): List Azure repositories
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/azure-projects`](https://developers.lingohub.com/reference/v2/operations/listazureprojects.md): List Azure projects
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/azure-organizations`](https://developers.lingohub.com/reference/v2/operations/listazureorganizations.md): List Azure organizations
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/azure-directory-entries`](https://developers.lingohub.com/reference/v2/operations/listazuredirectoryentries.md): List Azure directory entries
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/azure-branches`](https://developers.lingohub.com/reference/v2/operations/listazurebranches.md): List Azure branches

### [CodeCommit Integrations](https://developers.lingohub.com/reference/v2/operations/tags/codecommit-integrations.md)

List AWS CodeCommit repositories, branches and folders for a Git integration.

- [`GET /v2/integration-authentications/{integrationAuthenticationId}/codecommit-repositories`](https://developers.lingohub.com/reference/v2/operations/listcodecommitrepositories.md): List CodeCommit repositories
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/codecommit-directory-entries`](https://developers.lingohub.com/reference/v2/operations/listcodecommitdirectoryentries.md): List CodeCommit directory entries
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/codecommit-branches`](https://developers.lingohub.com/reference/v2/operations/listcodecommitbranches.md): List CodeCommit branches
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/codecommit-branch`](https://developers.lingohub.com/reference/v2/operations/getcodecommitbranch.md): Retrieve a CodeCommit branch

## Content integrations

### [Contentful Integrations](https://developers.lingohub.com/reference/v2/operations/tags/contentful-integrations.md)

Connect a project to Contentful, choose what it translates, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/contentful/sync`](https://developers.lingohub.com/reference/v2/operations/synccontentfulintegration.md): Sync with Contentful
- [`POST /v2/projects/{projectId}/integrations/contentful/push`](https://developers.lingohub.com/reference/v2/operations/pushcontentfulintegration.md): Push to Contentful
- [`POST /v2/projects/{projectId}/integrations/contentful/pull`](https://developers.lingohub.com/reference/v2/operations/pullcontentfulintegration.md): Pull from Contentful
- [`POST /v2/integrations/contentful/projects`](https://developers.lingohub.com/reference/v2/operations/createcontentfulproject.md): Create a Contentful project
- [`GET /v2/projects/{projectId}/integrations/contentful`](https://developers.lingohub.com/reference/v2/operations/getprojectcontentfulintegration.md): Retrieve the Contentful integration
- [`PATCH /v2/projects/{projectId}/integrations/contentful`](https://developers.lingohub.com/reference/v2/operations/updateprojectcontentfulintegration.md): Update the Contentful integration
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/contentful-spaces`](https://developers.lingohub.com/reference/v2/operations/listcontentfulspaces.md): List Contentful spaces
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/contentful-languages`](https://developers.lingohub.com/reference/v2/operations/listcontentfullanguages.md): List Contentful languages
- [`GET /v2/integration-authentications/{integrationAuthenticationId}/contentful-environments`](https://developers.lingohub.com/reference/v2/operations/listcontentfulenvironments.md): List Contentful environments

### [Storyblok Integrations](https://developers.lingohub.com/reference/v2/operations/tags/storyblok-integrations.md)

Connect a project to Storyblok, choose what it translates, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/storyblok/sync`](https://developers.lingohub.com/reference/v2/operations/syncstoryblokintegration.md): Sync with Storyblok
- [`POST /v2/projects/{projectId}/integrations/storyblok/push`](https://developers.lingohub.com/reference/v2/operations/pushstoryblokintegration.md): Push to Storyblok
- [`POST /v2/projects/{projectId}/integrations/storyblok/pull`](https://developers.lingohub.com/reference/v2/operations/pullstoryblokintegration.md): Pull from Storyblok
- [`POST /v2/integrations/storyblok/projects`](https://developers.lingohub.com/reference/v2/operations/createstoryblokproject.md): Create a Storyblok project
- [`GET /v2/projects/{projectId}/integrations/storyblok`](https://developers.lingohub.com/reference/v2/operations/getprojectstoryblokintegration.md): Retrieve the Storyblok integration
- [`PATCH /v2/projects/{projectId}/integrations/storyblok`](https://developers.lingohub.com/reference/v2/operations/updateprojectstoryblokintegration.md): Update the Storyblok integration

### [HubSpot Integrations](https://developers.lingohub.com/reference/v2/operations/tags/hubspot-integrations.md)

Connect a project to HubSpot, choose what it translates, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/hubspot/sync`](https://developers.lingohub.com/reference/v2/operations/synchubspotintegration.md): Sync with HubSpot
- [`POST /v2/projects/{projectId}/integrations/hubspot/push`](https://developers.lingohub.com/reference/v2/operations/pushhubspotintegration.md): Push to HubSpot
- [`POST /v2/projects/{projectId}/integrations/hubspot/pull`](https://developers.lingohub.com/reference/v2/operations/pullhubspotintegration.md): Pull from HubSpot
- [`POST /v2/integrations/hubspot/projects`](https://developers.lingohub.com/reference/v2/operations/createhubspotproject.md): Create a HubSpot project
- [`GET /v2/projects/{projectId}/integrations/hubspot`](https://developers.lingohub.com/reference/v2/operations/getprojecthubspotintegration.md): Retrieve the HubSpot integration
- [`PATCH /v2/projects/{projectId}/integrations/hubspot`](https://developers.lingohub.com/reference/v2/operations/updateprojecthubspotintegration.md): Update the HubSpot integration

### [Zendesk Integrations](https://developers.lingohub.com/reference/v2/operations/tags/zendesk-integrations.md)

Connect a project to Zendesk, choose what it translates, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/zendesk/sync`](https://developers.lingohub.com/reference/v2/operations/synczendeskintegration.md): Sync with Zendesk
- [`POST /v2/projects/{projectId}/integrations/zendesk/push`](https://developers.lingohub.com/reference/v2/operations/pushzendeskintegration.md): Push to Zendesk
- [`POST /v2/projects/{projectId}/integrations/zendesk/pull`](https://developers.lingohub.com/reference/v2/operations/pullzendeskintegration.md): Pull from Zendesk
- [`POST /v2/integrations/zendesk/projects`](https://developers.lingohub.com/reference/v2/operations/createzendeskproject.md): Create a Zendesk project
- [`GET /v2/projects/{projectId}/integrations/zendesk`](https://developers.lingohub.com/reference/v2/operations/getprojectzendeskintegration.md): Retrieve the Zendesk integration
- [`PATCH /v2/projects/{projectId}/integrations/zendesk`](https://developers.lingohub.com/reference/v2/operations/updateprojectzendeskintegration.md): Update the Zendesk integration

### [Stripo Integrations](https://developers.lingohub.com/reference/v2/operations/tags/stripo-integrations.md)

Connect a project to Stripo, choose what it translates, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/stripo/sync`](https://developers.lingohub.com/reference/v2/operations/syncstripointegration.md): Sync with Stripo
- [`POST /v2/projects/{projectId}/integrations/stripo/push`](https://developers.lingohub.com/reference/v2/operations/pushstripointegration.md): Push to Stripo
- [`POST /v2/projects/{projectId}/integrations/stripo/pull`](https://developers.lingohub.com/reference/v2/operations/pullstripointegration.md): Pull from Stripo
- [`POST /v2/integrations/stripo/projects`](https://developers.lingohub.com/reference/v2/operations/createstripoproject.md): Create a Stripo project
- [`GET /v2/projects/{projectId}/integrations/stripo`](https://developers.lingohub.com/reference/v2/operations/getprojectstripointegration.md): Retrieve the Stripo integration
- [`PATCH /v2/projects/{projectId}/integrations/stripo`](https://developers.lingohub.com/reference/v2/operations/updateprojectstripointegration.md): Update the Stripo integration

### [Crisp Helpdesk Integrations](https://developers.lingohub.com/reference/v2/operations/tags/crisp-helpdesk-integrations.md)

Connect a project to Crisp Helpdesk, and sync, push or pull its content.

- [`POST /v2/projects/{projectId}/integrations/crisp-helpdesk/sync`](https://developers.lingohub.com/reference/v2/operations/synccrisphelpdeskintegration.md): Sync with Crisp Helpdesk
- [`POST /v2/projects/{projectId}/integrations/crisp-helpdesk/push`](https://developers.lingohub.com/reference/v2/operations/pushcrisphelpdeskintegration.md): Push to Crisp Helpdesk
- [`POST /v2/projects/{projectId}/integrations/crisp-helpdesk/pull`](https://developers.lingohub.com/reference/v2/operations/pullcrisphelpdeskintegration.md): Pull from Crisp Helpdesk
- [`POST /v2/integrations/crisp-helpdesk/projects`](https://developers.lingohub.com/reference/v2/operations/createcrisphelpdeskproject.md): Create a Crisp Helpdesk project
- [`GET /v2/projects/{projectId}/integrations/crisp-helpdesk`](https://developers.lingohub.com/reference/v2/operations/getprojectcrisphelpdeskintegration.md): Retrieve the Crisp Helpdesk integration

## Logs

### [API Logs](https://developers.lingohub.com/reference/v2/operations/tags/api-logs.md)

Read the workspace's API request log. Each entry records one request, without its payload. How long entries are kept depends on the workspace's plan.

- [`GET /v2/api-logs`](https://developers.lingohub.com/reference/v2/operations/listapilogs.md): List API logs
- [`GET /v2/api-logs/{apiLogId}`](https://developers.lingohub.com/reference/v2/operations/getapilog.md): Retrieve an API log

### [Audit Logs](https://developers.lingohub.com/reference/v2/operations/tags/audit-logs.md)

Read the workspace's audit log: who changed what, and when.

- [`GET /v2/audit-logs`](https://developers.lingohub.com/reference/v2/operations/listauditlogs.md): List workspace audit logs
- [`GET /v2/audit-logs/{auditLogId}`](https://developers.lingohub.com/reference/v2/operations/getauditlog.md): Retrieve a workspace audit log
