Skip to content

Coupon pool detail with generation progress

Requires VIEWER.

projectId
required
string

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

id
required
string

Pool with generatedCount.

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
generatedCount
integer

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

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}

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

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}

Resource not found (or cross-tenant — same 404).

Media typeapplication/json
object
error
required

Human-readable error message.

string
message
string
Examplegenerated
json
{
"error": "example",
"message": "example"
}