Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
giveaway

Draw winners (creator only)

Draw winners for the giveaway. Requires the account JWT of the giveaway creator.

For random selection (selection_mode='random'): Send empty body {}. System will randomly select winners weighted by entry count.

For manual selection (selection_mode='manual'): Provide winner_account_ids list with account IDs in rank order.

post/v1/giveaway/{giveaway_id}/draw

Path parameters

giveaway_idstring required

Giveaway ID

Giveaway ID

Headers

authorizationstring nullable

Bearer <account_jwt>

Bearer <account_jwt>

Request body

winner_account_idsstring[] nullable

For manual selection: list of account IDs to select as winners (in rank order)

Example request

{
  "winner_account_ids": [
    "acc-123...",
    "acc-456..."
  ]
}

Response

Successful Response

giveaway_idstring required
drawn_atstring date-time required