Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
giveaway

Update giveaway (creator only)

Update giveaway settings. Requires the account JWT of the giveaway creator.

Editable fields:

  • title: Update the giveaway title
  • description: Update the giveaway description
  • end_at: Extend the end time (cannot shorten)
  • num_winners: Change number of winners
put/v1/giveaway/{giveaway_id}

Path parameters

giveaway_idstring required

Giveaway ID

Giveaway ID

Headers

authorizationstring nullable

Bearer <account_jwt>

Bearer <account_jwt>

Request body

titlestring nullable

Updated title

descriptionstring nullable

Updated description

end_atstring date-time nullable

Extended end time (can only extend, not shorten)

num_winnersinteger nullable

Updated number of winners

Response

Successful Response

idstring required
creator_account_idstring required
earning_addressstring nullable
creator_handlestring nullable
creator_ens_namestring nullable
creator_base_namestring nullable
titlestring required
descriptionstring required
minimum_tip_usdstring required
allow_multiple_entriesboolean required
num_winnersinteger required
selection_modestring required
networkstring required
token_symbolstring required
start_atstring date-time required
end_atstring date-time required
statusstring required
created_atstring date-time required
updated_atstring date-time required
drawn_atstring date-time nullable
is_winnerboolean nullable
creator_addressstring nullable required