Slot

A slot (aka a time slot) is the marriage of a DayPart and a Space. You must have the scheduling ConventionPrivilege to access this. Slots are accessed via /api/slot.

Properties

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

Complete details in SlotProperties. It also has these extra read-only properties:

is_assigned

Lets you know whether this slot is used.

Related Objects

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

convention

The Convention this slot belongs to.

conventionday

The ConventionDay this slot takes place in.

daypart

The DayPart this slot takes place in.

event

The Event using this slot (if any). This is also set if the slot is used by an Event's EventSession.

eventsession

The EventSession using this slot (if any).

room

The Room this slot takes place in.

space

The Space this slot takes place in.

Services

The services used to fetch and manipulate slots.

Search Slots

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

 GET /api/slot
Optional Params
query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "Table E3 in Chippewa Ballroom on Friday at 10am",
          ...
        },
        ...
    ]
 }

Read Slot

 GET /api/slot/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "Table E3 in Chippewa Ballroom on Friday at 10am",
   ...
 }

Create Slot

Slots are generated for you by the system. Create your own slots at your own risk.

 POST /api/slot
Required Params

Formerly, convention_id, conventionday_id, and room_id were required, but not any more. A Slot's convention_id and conventionday_id will come from its DayPart, and its room_id will come from its Space.

daypart_id
space_id

Returns the same as a normal read.

Update Slot

The URI /api/slot/xxx no longer accepts edit (PUT) requests.

The only Slot properties that can be changed for a slot is its is_reserved field, and its event_id field. See below for service endpoints for editing these values.

Delete Slot

 DELETE /api/slot/xxx

Returns:

 {
   "success" : 1
 }

Assign Slot

Sets a Slot's associated event_id.

 PUT /api/slot/xxx/assign
Required Params
event_id

Returns the same as a normal read.

Un-Assign Slot

Removes a Slot's associated event_id.

 PUT /api/slot/xxx/unassign

Returns the same as a normal read.

Reserve Slot

Sets a Slot to reserved.

 PUT /api/slot/xxx/reserve

Returns the same as a normal read.

Un-Reserve Slot

Removes a Slot's reserved setting.

 PUT /api/slot/xxx/unreserve

Returns the same as a normal read.