Event Submission

Allows users to submit ideas for Events that they would like to run. You must have the scheduling ConventionPrivilege to manage this, but you need no special privilges to submit them or update the ones you created. Event Submissions are accessed via /api/eventsubmission.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in EventSubmissionProperties.

Deprecation Note -- August 2022

Field max_tickets is deprecated and replaced in use by max_quantity.

Related Objects

See "Related Objects" in Introduction for how to use them.

alternatedaypart

The DayPart this event submission would like to start at if the preferred daypart is not available.

convention

The Convention this event submission belongs to.

preferreddaypart

The DayPart this event submission would like to start at.

type

The EventType this event submission will conform to.

Relationships

See "Relationships" in Introduction for how to use them.

events

The list of Events that was generated from this submission.

Queryable
Qualifiers

invitees

The list of Users with EventReservations for this event (if any).

reservations

EventReservations for this event (if any).

sessions

EventSubmissionSessions created for this event submission. Note this set does not include the information for the submission's first session, which is stored with the submission.

Includes

See "Includes" in Introduction for how to use them.

has_event

Returns 1 if the event submission has an existing Event, 0 if not.

is_multi_session

Adds two additional properties: is_multi_session, which is if the event has more than one session, and is_multi_day, which is if the sessions occur on more than one conventionday. 1 if true, 0 if not.

Note that events have a session_count field which will show the total number of separate sessions the event has, and this is always returned with an object read.

reservations

Returns an array of reservations in the following format:

 [
   {
     "name"     : "John Q. Normal",
     "champion" : 1,
   },
   { .. }
 ]

Services

The services used to fetch and manipulate event submissions.

Search Event Submissions

This will search across all conventions. To search on a single convention see "Relationships" in Convention.

 GET /api/eventsubmission
Optional Params
query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "The Captain is Dead",
          ...
        },
        ...
    ]
 }

Create Event Submission

 POST /api/eventsubmission
Required Params
convention_id
name
max_tickets
type_id
preferreddaypart_id
alternatedaypart_id

Returns the same as a normal read.

Read Event Submission

 GET /api/eventsubmission/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "The Captain is Dead",
   ...
 }

Update Event Submission

 PUT /api/eventsubmission/xxx

Returns the same as a normal read.

Delete Event Submission

 DELETE /api/eventsubmission/xxx

Returns:

 {
   "success" : 1
 }

Queue Event Submission

Queues this submission for scheduling.

 POST /api/eventsubmission/xxx/queue
Optional Params
priority

Defaults to priority 3 (aka Normal), but can be as low as 1 or as high as 5 or anything in between.

comment

A message the submitter will be able to see.

Decline Event Submission

Rejects this submission.

 POST /api/eventsubmission/xxx/decline
Optional Params
comment

A message the submitter will be able to see.

Move to In-Review Queue Event Submission

Move this submission to the In-Review queue.

 POST /api/eventsubmission/xxx/review
Optional Params
comment

A message the submitter will be able to see.

Request Changes of Event Submission

Ask for changes for this submission.

 POST /api/eventsubmission/xxx/change
Optional Params
comment

A message the submitter will be able to see.

Add Reservation to Event Submission

Adds a reservation to an EventSubmission. For users without elevated privileges, the only Users who can be given a reservation are the user's TTE friends (see Friendship).

 POST /api/eventsubmission/xxx/attendee-reservation
Required Params
user_id

Returns the same as a normal read.

Remove Reservation from Event Submission

Removes a reservation from an EventSubmission. See also EventSubmissionReservation.

 DELETE /api/eventsubmission/xxx/attendee-reservation/:reservation_id

Returns the same as a normal read.