# Discord signups

## `GET /api/guilds/{guild_id}/events/{event_id}/signups/by-discord/{discord_id}`

**Get a member's event signup by Discord ID**

Returns the member's current signup for an event, plus their most recent character, class, and role. Returns 404 for any guild_id other than the SideQuest server, an unknown event, or a Discord ID with no site account.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes | The Discord server ID. Only the SideQuest server works. |
| `event_id` | path | string (uuid) | yes | The event's ID. |
| `discord_id` | path | integer | yes | The member's Discord user ID. |

**Response `200` — The member's signup for the event.**

Model: {ref}`SignupByDiscord <model-signupbydiscord>`

| Field | Type | Required | Description |
|---|---|---|---|
| `signup` | {ref}`Signup <model-signup>` \| null | yes |  |
| `defaults` | {ref}`SignupDefaults <model-signupdefaults>` \| null | yes |  |
| `kind` | {ref}`EventKind <model-eventkind>` | yes |  |


## `PUT /api/guilds/{guild_id}/events/{event_id}/signups/by-discord/{discord_id}`

**Create or replace a member's event signup by Discord ID**

Creates or replaces the member's signup for an event, identified by Discord ID. Returns 404 for any guild_id other than the SideQuest server, an unknown event, or a Discord ID with no site account. Returns 409 if the event is not scheduled. Returns 400 if the event's kind is raid or dungeon and character, class, or role are missing, unless status is absent.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes | The Discord server ID. Only the SideQuest server works. |
| `event_id` | path | string (uuid) | yes | The event's ID. |
| `discord_id` | path | integer | yes | The member's Discord user ID. |

**Request body**

Model: {ref}`SignupUpsert <model-signupupsert>`

| Field | Type | Required | Description |
|---|---|---|---|
| `character` | string \| null | no |  |
| `class` | {ref}`WowClass <model-wowclass>` \| null | no |  |
| `role` | {ref}`SignupRole <model-signuprole>` \| null | no |  |
| `status` | {ref}`SignupStatus <model-signupstatus>` | yes |  |
| `comment` | string \| null | no |  |

**Response `200` — The created or updated signup.**

Model: {ref}`Signup <model-signup>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `member` | {ref}`SignupMember <model-signupmember>` | yes |  |
| `character` | string \| null | yes |  |
| `class` | {ref}`WowClass <model-wowclass>` \| null | yes |  |
| `role` | {ref}`SignupRole <model-signuprole>` \| null | yes |  |
| `status` | {ref}`SignupStatus <model-signupstatus>` | yes |  |
| `comment` | string \| null | yes |  |
| `group` | integer \| null | yes |  |
| `bench` | boolean | yes |  |
| `updated_at` | string (date-time) | yes |  |