Trigger batch coupon generation (idempotent)

Requires ADMIN. Only draft/generating pools are eligible. Enqueues via INCENTIVE_COUPON_GENERATION queue.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Project (tenant) identifier. Row-level tenant isolation is enforced on every query.

id

required

string

Responses

200

Job already queued (idempotent hit).

Media typeapplication/json

object

jobId

string

status

string

message

string

202

Generation job enqueued.

Media typeapplication/json

object

jobId

string

status

string

Example

json

{
  "status": "queued"
}

400

Missing/invalid path input (e.g. projectId) or invalid JSON body.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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

403

Not authenticated (401 via requireAuthenticated) or insufficient project role (403).

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 cross-tenant — same 404).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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

409

Pool status not eligible for generation (error=pool_not_eligible).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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

422

Invalid pool (error=invalid_pool).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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

503

Generation queue binding unavailable (error=queue_unavailable).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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