Queue one image for private sanitization

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.

PUT /api/v1/workspaces/{workspaceId}/projects/{projectId}/branches/{branchId}/keys/{keyId}/images/{imageId}/file

Operation: uploadKeyImage · 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.
keyId	path	Yes	See constraints below.
imageId	path	Yes	See constraints below.
Origin	header	Yes	See constraints below.
X-CSRF-Token	header	Yes	See constraints below.

workspaceId

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

projectId

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

branchId

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

keyId

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

imageId

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

Origin

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

X-CSRF-Token

{
  "type": "string"
}

Request body

Required: Yes.

multipart/form-data

Field	Type	Required	Constraints / description
file	string	Yes	format: "binary"

{
  "type": "object",
  "required": [
    "file"
  ],
  "properties": {
    "file": {
      "type": "string",
      "format": "binary"
    }
  },
  "additionalProperties": false
}

Responses

202

Result returned.

Content type: application/json Schema reference: ImageQueued.

Field	Type	Required	Constraints / description
id	string	Yes	format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
state	string	Yes	—

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

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