Skip to content

API V2 (Beta) · Invitations

List email invitations

GET
/v2/invitations
curl --request GET \
--url https://api.lingohub.com/v2/invitations \
--header 'Authorization: Bearer YOUR_API_KEY'

Lists the workspace’s email invitations in every state (pending, accepted, declined, expired). Invite links aren’t included. Requires workspace-level members view permission.

filter
Media typeapplication/json

The filter of a list: which items to return and in which order.

object
where

Exactly one of _and and _or, with the clauses it combines.

object
>= 1 properties <= 1 properties
_and
Array<object>
>= 1 items

A nested _and/_or, or one field with one operator.

object
>= 1 properties <= 1 properties
_and
Array<object> recursive
_or
Array<object> recursive
invitation[accepted_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[created_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[declined_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[email]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[expires_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[id]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_in
Array<string>
>= 1 items
_nin
Array<string>
>= 1 items
invitation[invitee_name]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[is_stack_assignment_configured]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_true

Takes no value; send true.

boolean
_false

Takes no value; send true.

boolean
invitation[message]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[status]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_ne
string
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_in
Array<string>
>= 1 items
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_nin
Array<string>
>= 1 items
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
invitation[updated_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[workspace_role_id]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_in
Array<string>
>= 1 items
_nin
Array<string>
>= 1 items
_or
Array<object>
>= 1 items

A nested _and/_or, or one field with one operator.

object
>= 1 properties <= 1 properties
_and
Array<object> recursive
_or
Array<object> recursive
invitation[accepted_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[created_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[declined_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[email]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[expires_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[id]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_in
Array<string>
>= 1 items
_nin
Array<string>
>= 1 items
invitation[invitee_name]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[is_stack_assignment_configured]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_true

Takes no value; send true.

boolean
_false

Takes no value; send true.

boolean
invitation[message]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_like
string
_nlike
string
_ilike
string
_nilike
string
_contains
string
_ncontains
string
_icontains
string
_nicontains
string
_starts
string
_ends
string
_blank

Takes no value; send true.

boolean
_nblank

Takes no value; send true.

boolean
invitation[status]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_ne
string
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_in
Array<string>
>= 1 items
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
_nin
Array<string>
>= 1 items
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
invitation[updated_at]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string format: date-time
_lt
string format: date-time
_gt
string format: date-time
_lte
string format: date-time
_gte
string format: date-time
_within

The lower and the upper bound.

Array<string>
>= 2 items <= 2 items
_null

Takes no value; send true.

boolean
_nnull

Takes no value; send true.

boolean
invitation[workspace_role_id]

Exactly one operator of the field.

object
>= 1 properties <= 1 properties
_eq
string
_ne
string
_in
Array<string>
>= 1 items
_nin
Array<string>
>= 1 items
sort

Fields to sort by, in order: + ascending, - descending.

Array<string>
<= 8 items
Allowed values: +invitation[created_at] -invitation[created_at] +invitation[expires_at] -invitation[expires_at] +invitation[updated_at] -invitation[updated_at]

Filters and sorts the list: URL-encoded JSON of the schema InvitationFilter. 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.

Field Type Operators Sort
invitation[accepted_at] timestamp _eq _lt _gt _lte _gte _within _null _nnull –
invitation[created_at] timestamp _eq _lt _gt _lte _gte _within _null _nnull yes
invitation[declined_at] timestamp _eq _lt _gt _lte _gte _within _null _nnull –
invitation[email] text _eq _ne _like _nlike _ilike _nilike _contains _ncontains _icontains _nicontains _starts _ends _blank _nblank –
invitation[expires_at] timestamp _eq _lt _gt _lte _gte _within _null _nnull yes
invitation[id] id _eq _ne _in _nin –
invitation[invitee_name] text _eq _ne _like _nlike _ilike _nilike _contains _ncontains _icontains _nicontains _starts _ends _blank _nblank –
invitation[is_stack_assignment_configured] boolean _true _false –
invitation[message] text _eq _ne _like _nlike _ilike _nilike _contains _ncontains _icontains _nicontains _starts _ends _blank _nblank –
invitation[status] ACCEPTED | DECLINED | EXPIRED | PENDING _eq _ne _in _nin –
invitation[updated_at] timestamp _eq _lt _gt _lte _gte _within _null _nnull yes
invitation[workspace_role_id] id _eq _ne _in _nin –
cursor
string

Opaque pagination cursor from the next_cursor field of a previous response. Omit for the first page.

limit
integer format: int32
default: 20 >= 1 <= 100

Maximum number of items to return per page (1-100).

Example

20

Email invitations retrieved.

Media typeapplication/json

A cursor-paginated collection of retained email invitations.

object
object_type
required

Always LIST.

string
Allowed values: LIST
has_more
required

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.

boolean
next_cursor
required

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.

string | null
data
required

The list of items in this page.

Array<object>

Retained email-invitation metadata without its bearer token, acceptance URL or private assignment payload. LINK invitations are excluded.

object
object_type
required

Always INVITATION.

string
Allowed values: INVITATION
id
required

Public identity of the email invitation.

string
>= 1 characters
workspace_role_id
required

Workspace role requested by the invitation.

string
inviter_email
required

Email address of who sent the invitation: the inviting user, or the owner of the personal (USER_OWNED) API key it was sent with. Null when a workspace-managed API key or LingoHub sent it, and once that user or key no longer exists.

string | null
email
required

Invited email address, if retained.

string | null
invitee_name
required

Display name of the LingoHub account the invited email belonged to when the invitation was created; null when the email had no account. It is never supplied by the inviter.

string | null
message
required

Message stored with the invitation, if supplied.

string | null
is_stack_assignment_configured
required

Whether a stack assignment was configured; its details and current validity are outside this metadata resource.

boolean
status
required

Computed current state. Expiration can change the state without changing updated_at.

string
Allowed values: ACCEPTED DECLINED EXPIRED PENDING
expires_at
required

Stored expiry time; pending invitations expire after this instant.

string format: date-time
accepted_at
required

Stored email acceptance time, if accepted.

string | null format: date-time
declined_at
required

Stored email decline time, if declined.

string | null format: date-time
created_at
required

Time the invitation was created.

string format: date-time
updated_at
required

Stored invitation metadata update time; elapsed expiry does not update it.

string format: date-time

Example

{
"object_type": "LIST",
"has_more": true,
"next_cursor": "1uO9WTLnYqGAtIWkjDmz4VuJZWLkWMxXIH4Hkp2DTuRtPNQYBpkF6Q",
"data": [
{
"object_type": "INVITATION",
"id": "svi_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"workspace_role_id": "rol_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"inviter_email": "owner@example.com",
"email": "alex@example.com",
"invitee_name": "Alex",
"message": "Welcome to the translation team.",
"is_stack_assignment_configured": false,
"status": "PENDING",
"expires_at": "2026-09-29T10:00:00.123Z",
"accepted_at": "2026-09-29T10:00:00.123Z",
"declined_at": "2026-09-29T10:00:00.123Z",
"created_at": "2026-09-29T10:00:00.123Z",
"updated_at": "2026-09-29T10:00:00.123Z"
}
]
}
RateLimit
string

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.

RateLimit-Policy
string

The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.

The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. code names the problem, errors the parameter or field.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}
RateLimit
string

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.

RateLimit-Policy
string

The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.

Invalid or missing API key.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}

Insufficient permissions.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}
RateLimit
string

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.

RateLimit-Policy
string

The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.

The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}
Retry-After
integer format: int32

Seconds to wait before retrying.

RateLimit
string

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.

RateLimit-Policy
string

The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.

An unexpected internal server error occurred.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}
RateLimit
string

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.

RateLimit-Policy
string

The rate-limit policies applied to the request: each quoted policy name with q = sustained request quota per window of w seconds. Example: "api-key";q=180;w=60, "workspace";q=600;w=60. Advisory: absent when the request fails authentication or the limiter state is momentarily unknown.

The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.

Media typeapplication/problem+json

RFC 9457 problem details. code identifies the problem type (one per type URL); errors lists rejected fields or parameters; required_permission names the permission a 403 lacked.

object
type
required

URL identifying the problem type and pointing to its documentation.

string
title
required

Short, constant summary of the problem type.

string
status
required

HTTP status code.

integer format: int32
detail
required

Human-readable explanation of this occurrence of the problem.

string
instance
required

Path of the request that produced the problem.

string
code
required

Machine-readable problem type.

string
Allowed values: 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
request_id
required

Correlation id of the request, also returned in the X-Request-ID header. Quote it when contacting support.

string
errors

Rejected fields or parameters. Present when the problem concerns specific fields or parameters.

Array<object>

A rejected field or parameter. pointer locates a body field (RFC 6901 JSON Pointer), parameter a query, path or header parameter or a field of a multipart upload; both are set for a position inside a JSON-valued parameter such as filter.

object
detail
required

Human-readable description of the problem.

string
pointer
required

JSON Pointer to the offending body field, or to the position inside a JSON-valued parameter.

string | null
parameter
required

Name of the offending query, path or header parameter, or of the multipart form field.

string | null
code
required

Why the field or parameter was rejected.

string
Allowed values: 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
required_permission

The permission the API key lacks. Present on 403 responses.

object
scope
required

Where the permission applies.

string
Allowed values: WORKSPACE STACK
target
required

The area the permission governs.

string
Allowed values: 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
level
required

The access level required.

string
Allowed values: NO_ACCESS VIEW WRITE MANAGE

Example

{
"type": "https://api.lingohub.com/errors/resource-not-found",
"title": "Resource not found",
"status": 404,
"detail": "Resource with ID 'pr_0197c8f2-5a6b-7cde-8f12-3456789abcde' was not found.",
"instance": "/v2/projects/pr_0197c8f2-5a6b-7cde-8f12-3456789abcde",
"code": "invalid_json",
"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"errors": [
{
"detail": "must be at least 2 characters long",
"pointer": "#/name",
"parameter": "limit",
"code": "minLength"
}
],
"required_permission": {
"scope": "WORKSPACE",
"target": "GENERAL",
"level": "NO_ACCESS"
}
}
Retry-After
integer format: int32

Seconds to wait before retrying.

RateLimit
string

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.

RateLimit-Policy
string

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.