Events
Bnder API documentation for Events. Read the API Overview to get started and learn more.
Create a new event
Create a new event for the guild
POST/consumer/v1/guilds/guildId /events
| Parameters | Description |
|---|---|
| guildId | The id of a discord guild |
Request body
empty
Response
Status: 200 - Event created
| Field | Type | Description |
|---|---|---|
| id | string | Id of the event |
| title | string | Title of the event |
| location | string | Location of the event |
| start | string | Start date and time of the event |
| end | string | End date and time of the event |
| isFromTask | boolean | Is the event from a task deadline |
| invitees | array | Discord user ids of the invitees |
| accepted | array | Discord user ids of the accepted invitees |
| declined | array | Discord user ids of the declined invitees |
| creator | string | Discord user id of the creator |
| repeated | boolean | Is the event repeated |
| repeatEnd | string | End date of the repeat |
| repeatIntervalDays | number | Interval in days for the repeat |
Get an event
Get an event by ID
GET/consumer/v1/guilds/guildId /events/eventId
| Parameters | Description |
|---|---|
| guildId | The id of a discord guild |
| eventId | The ID of the event |
Request body
empty
Response
Status: 200 - Event retrieved
| Field | Type | Description |
|---|---|---|
| id | string | Id of the event |
| title | string | Title of the event |
| location | string | Location of the event |
| start | string | Start date and time of the event |
| end | string | End date and time of the event |
| isFromTask | boolean | Is the event from a task deadline |
| invitees | array | Discord user ids of the invitees |
| accepted | array | Discord user ids of the accepted invitees |
| declined | array | Discord user ids of the declined invitees |
| creator | string | Discord user id of the creator |
| repeated | boolean | Is the event repeated |
| repeatEnd | string | End date of the repeat |
| repeatIntervalDays | number | Interval in days for the repeat |
Update an event
Update an existing event
PUT/consumer/v1/guilds/guildId /events/eventId
| Parameters | Description |
|---|---|
| guildId | The id of a discord guild |
| eventId | The ID of the event |
Request body
empty
Response
Status: 200 - Event updated
| Field | Type | Description |
|---|---|---|
| id | string | Id of the event |
| title | string | Title of the event |
| location | string | Location of the event |
| start | string | Start date and time of the event |
| end | string | End date and time of the event |
| isFromTask | boolean | Is the event from a task deadline |
| invitees | array | Discord user ids of the invitees |
| accepted | array | Discord user ids of the accepted invitees |
| declined | array | Discord user ids of the declined invitees |
| creator | string | Discord user id of the creator |
| repeated | boolean | Is the event repeated |
| repeatEnd | string | End date of the repeat |
| repeatIntervalDays | number | Interval in days for the repeat |
Delete an event
Delete an existing event
DELETE/consumer/v1/guilds/guildId /events/eventId
| Parameters | Description |
|---|---|
| guildId | The id of a discord guild |
| eventId | The ID of the event |
Request body
empty
Response
Status: 204 - Event deleted
empty response
Plan an event
Plan an event for the guild
POST/consumer/v1/guilds/guildId /events/plan
| Parameters | Description |
|---|---|
| guildId | The id of a discord guild |
Request body
empty
Response
Status: 200 - Event planned
| Field | Type | Description |
|---|---|---|
| id | string | Id of the event |
| title | string | Title of the event |
| location | string | Location of the event |
| start | string | Start date and time of the event |
| end | string | End date and time of the event |
| isFromTask | boolean | Is the event from a task deadline |
| invitees | array | Discord user ids of the invitees |
| accepted | array | Discord user ids of the accepted invitees |
| declined | array | Discord user ids of the declined invitees |
| creator | string | Discord user id of the creator |
| repeated | boolean | Is the event repeated |
| repeatEnd | string | End date of the repeat |
| repeatIntervalDays | number | Interval in days for the repeat |