Atomically approve or revoke selected saved revisions

Requires current workspace membership. Manager-only operations include permission and project-link management. Text approval requires a separate language review grant; resource editor access never grants translation permissions. Expected versions and branch scope are checked before mutation. Source and context text are not telemetry.

POST /api/v1/workspaces/{workspaceId}/projects/{projectId}/branches/{branchId}/keys/reviews

Operation: reviewTranslations · Download OpenAPI

Access

This operation does not use the panel session as its authentication mechanism. Follow the operation-specific checks described above.

session

{
  "type": "apiKey",
  "in": "cookie",
  "name": "localisync_session"
}

Parameters

Name	Location	Required	Description
workspaceId	path	Yes	See constraints below.
projectId	path	Yes	See constraints below.
branchId	path	Yes	See constraints below.
Origin	header	Yes	See constraints below.
X-CSRF-Token	header	Yes	See constraints below.
Idempotency-Key	header	Yes	See constraints below.

workspaceId

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

projectId

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

branchId

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

Origin

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

X-CSRF-Token

{
  "type": "string"
}

Idempotency-Key

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

Request body

Required: Yes.

application/json

Schema reference: ReviewInput.

Field	Type	Required	Constraints / description
approve	boolean	Yes	—
items	Array of object	Yes	minItems: 1; maxItems: 100

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

Responses

201

Result returned.

Content type: application/json Schema reference: ReviewResult.

Field	Type	Required	Constraints / description
items	Array of object	Yes	—

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

400

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

401

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

403

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

404

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

409

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

413

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

429

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

500

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

503

Safe error. Mutations are atomic.

Content type: application/json Schema reference: Error.

Field	Type	Required	Constraints / description
error	string	Yes	—
message	string	Yes	—
requestId	string	Yes	—
details	See schema	No	—

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

Related guidance

Request errors and safe retries · Troubleshooting