# Giveaways

### `a!wins`

{% tabs %}
{% tab title="Usage" %}

* `a!wins` - Shows the number of giveaway wins in total of a user.
  {% endtab %}
  {% endtabs %}

### `a!gwin-role`

{% tabs %}
{% tab title="Usage" %}

* `a!gwin-role` - View/manage current roles to be added to the winner of a giveaway.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/KHoxfVdGWpLQg5hhDjzM" alt=""><figcaption><p>a!winrole add ↗️</p></figcaption></figure>

<figure><img src="/files/ve87N2ONO6FZeCnTOCpf" alt=""><figcaption><p>a!winrole remove ↗️</p></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!gblacklist`

{% tabs %}
{% tab title="Usage" %}

* `a!gblacklist` - View/manage members from entering giveaways.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/Kn3KTHt37dAHws3rg50f" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!glist`

{% tabs %}
{% tab title="Usage" %}

* `a!glist` - View the current list of giveaways which are running in the server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/jSTGkXLBao5Lpk8WyI9F" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

`a!gcreate`

{% tabs %}
{% tab title="First Tab" %}

* `a!gcreate` - Sends a panel through which you can create a giveaway with requirements.
  {% endtab %}

{% tab title="Second Tab" %}

{% endtab %}
{% endtabs %}

### `a!gdelete`

{% tabs %}
{% tab title="Usage" %}

* `a!gdelete` - Deletes a giveaway from the server and the database.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/JtVcV3Ib19cU0crnmVPA" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!gend`

{% tabs %}
{% tab title="Usage" %}

* `a!gend` - Ends a currently running giveaway in this server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/Fw9EGLcn6tMyWEgL6YI4" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!greroll`

{% tabs %}
{% tab title="Usage" %}

* `a!greroll <msg_id>` - Rerolls a giveaway with a message ID (`msg_id` is optional).
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/TTjpIxbaDICC99Tu1P36" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

### `a!gstart`

{% tabs %}
{% tab title="Usage" %}

* `a!gstart <duration> <winners> <prize>` - Creates a giveaway in the server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="/files/SnFcb36ZI6PSMgIsDNEl" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!gcheck`

{% tabs %}
{% tab title="First Tab" %}

* `a!gcheck <giveaway-id> [user]` - Check if you or someone else is eligible to enter a giveaway which has certain requirement(s).
  {% endtab %}

{% tab title="Second Tab" %}

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Syntax usage:**

`<>` = Required argument (mandatory and must be included)

`[]` = Optional argument (not necessary to be included)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apollo-bot.xyz/commands/giveaways.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.