Read content history

All current members may read append-only content history, newest first. Includes actor, timestamp, locale, operation and before/after snapshots. There is no restore operation. Content is scoped to the explicit branch. Branch archives are read-only; current workspace roles still apply.

GET /api/v1/workspaces/{workspaceId}/projects/{projectId}/branches/{branchId}/keys/{keyId}/history

Operation: listTranslationHistory · Download OpenAPI

Access

Requires an authenticated Localisync panel session. The API checks current membership and permissions for workspace operations. See authentication and request rules.

sessionCookie

{
  "type": "apiKey",
  "in": "cookie",
  "name": "__Host-localisync-session",
  "description": "Opaque server session. Local HTTP development uses its explicitly configured development cookie name."
}

Parameters

Name	Location	Required	Description
`workspaceId`	path	Yes
`projectId`	path	Yes
`keyId`	path	Yes
`page`	query	No
`pageSize`	query	No
`branchId`	path	Yes	Explicit branch UUID in this project. No implicit main selection.
`locale`	query	No	Filter recorded language-specific events before pagination. Omit for complete key history, including shared definition changes. Inactive languages remain readable.

workspaceId

{
  "type": "string",
  "format": "uuid"
}

projectId

{
  "type": "string",
  "format": "uuid"
}

keyId

{
  "type": "string",
  "format": "uuid"
}

page

{
  "type": "integer",
  "minimum": 1,
  "maximum": 100000,
  "default": 1
}

pageSize

{
  "type": "integer",
  "minimum": 1,
  "maximum": 100,
  "default": 25
}

branchId

{
  "type": "string",
  "format": "uuid"
}

locale

{
  "type": "string",
  "minLength": 2,
  "maxLength": 255
}

Request body

No request body.

Responses

200

Committed result. Responses are private and Cache-Control: no-store.

Content type: application/json Schema reference: HistoryPage.

Field	Type	Required	Constraints / description
`items`	Array of object	Yes	—
`page`	integer	Yes	minimum: `1`
`pageSize`	integer	Yes	minimum: `1`; maximum: `100`
`hasMore`	boolean	Yes	—

{
  "$ref": "#/components/schemas/HistoryPage"
}

400

Invalid request or ICU value; field and locale issues may be included.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

401

Sign in to continue.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

403

Current role cannot perform this action.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

404

Project or key is not visible in the current workspace.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

409

Stale version, reserved key name, archive or inactive-language conflict. Compare current data before retrying.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

413

Mutation exceeds 1 MiB.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

429

Request limit exceeded.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

503

A required service is unavailable; no successful change is claimed.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
`error`	string	Yes	—
`message`	string	Yes	—
`requestId`	string	No	—
`details`	object	No	—
`statusCode`	integer	No	May be included by HTTP-level request limits.

{
  "$ref": "#/components/schemas/Error"
}

Request errors and safe retries · Troubleshooting