Update coupon pool status (suspend / archive)

Requires ADMIN.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

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

id

required

string

Request Body^required

Media typeapplication/json

object

>= 1 properties

status

string

Allowed values: draft generating active exhausted archived

Responses

200

Updated pool.

Media typeapplication/json

object

pool

object

id

string

projectId

string

name

string

form

string

Allowed values: random generic personal

codeLength

integer

totalCount

integer

perUserLimit

integer

validityDays

integer | null

benefitsJson

string | null

status

string

Allowed values: draft generating active exhausted archived

createdAt

string

updatedAt

string

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"
}

422

Zod validation failed (error=‘参数校验失败’ with issues[]).

Media typeapplication/json

object

error

required

string

issues

Array<object>

object

path

string

message

string

details

Array<object>

object

key

additional properties

any

key

additional properties

any

Example

json

{
  "error": "参数校验失败"
}