Generate an AI draft translation for a locale

Requires ADMIN and a configured Workers AI binding. Result always lands as status=draft, origin=ai; never auto-published. No request body.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Tenant project id (row-level isolation on every query).

templateId

required

string

Email template id.

locale

required

string

Language variant locale (normalized against the supported locale set).

Responses

200

Draft variant.

Media typeapplication/json

object

locale

object

id

string

projectId

string

templateId

string

locale

string

subject

string

htmlBody

string

textBody

string | null

status

string

Allowed values: draft published

origin

string

Allowed values: manual ai

createdBy

string | null

createdAt

string | null format: date-time

updatedAt

string | null format: date-time

400

Unsupported locale.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

401

Not authenticated (no valid session/principal).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Authenticated but lacks the required project role.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

404

Resource not found (or belongs to another project — indistinguishable).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

409

Locale already published.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

422

Placeholder mismatch in generated translation.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

502

AI generation failed.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

503

Workers AI binding not configured, or ai_unavailable.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}