Skip to content

giveaway

giveaway create

Creates a giveaway in your server.

Users can sign up for this giveaway by clicking the button below the posted embed.

Parameters:

Name Type Description Default
date app_commands.Transform[str, DateHoursMinutesTransformer

When the giveaway should end, a date in the format of YYYY-MM-DD HH:MM. This will assume UTC time.

required
winners int

The amount of winners for the giveaway.

required
title str

A title for your giveaway - will also be the title of the embed.

required
description str

An optional description for your giveaway. Defaults to None.

None

giveaway cancel

Cancels an existing giveaway.

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway attached to it.

required

giveaway date

Changes the date of a provided giveaway.

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway attached to it.

required
date app_commands.Transform[str, DateHoursMinutesTransformer]

The new date for the giveaway in the format of YYYY-MM-DD HH:MM - assumes UTC time

required

giveaway winners

Changes the amount of winners for a provided giveaway.

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway

required
winners app_commands.Range[int, 1, None]

The new amount of winners this giveaway should get.

required

giveaway title

Changes the title of a provided giveaway.

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway.

required
title str

The new title the giveaway should get.

required

giveaway participants

Shows you the amount of users currently signed up for a giveaway

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway.

required

giveaway reroll

Rerolls a specified amount of winners for a giveaway

Parameters:

Name Type Description Default
message app_commands.Transform[str, MessageTransformer]

A link or ID of a message with a giveaway.

required
winners int

The amount of winners you'd like to reroll.

required