Update a resource

patch

https://api.lingohub.com/v2/resources/{resourceId}

Partially updates the resource identified by the given ID (JSON merge-patch). Only fields present in the request body are changed; omitted fields are left unchanged. Renaming the path also moves the resource and its sub-resources within the branch. Returns the full updated resource. Requires project-level resource management permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

resourceId

string

required

^rc_[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}$

Unique identifier of the resource.

Body Params

Request body to partially update a resource (PATCH, JSON merge-patch). Only fields present in the request body are changed; omitted fields are left unchanged. Renaming the path also moves the resource and its sub-resources within the branch.

path

string

length between 1 and 4096

New full path of the resource within the branch: relative, segments separated by /, the last one naming the resource. No empty or .. segment, no segment longer than 255 characters. A file path must retain %{locale} somewhere in the path. When its basename combines %{locale} with other text, use %{language_code_separator} as the separator, for example messages%{language_code_separator}%{locale}.json. Keep an extension allowed by the resource's format. A folder path does not need a locale placeholder.

language_code_separator

string

length between 1 and 256

New separator used between the file name and the language code. Cannot be blank.

Headers

If-Match

string

Optional precondition. Send the quoted ETag from a GET of this resource. The mutation only runs if a strong tag matches the current representation, checked under the write lock. A comma-separated list is allowed; '*' requires an existing representation. Weak tags never match. Omit this header for an unconditional write. For an action, use the ETag from GET of the target resource, without the action suffix. A stale tag returns 412; read the current state before retrying.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Resource updated successfully.

400The 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.

401Invalid or missing API key.

403Insufficient permissions.

404Resource not found.

409Another resource already has this path (already_exists), an ancestor is a file, or another tree mutation is in progress (conflict). Refresh and retry a tree conflict.

412The current representation does not match If-Match (precondition_failed). No change was applied.

422Validation error.

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

500An unexpected internal server error occurred.

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