> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bloxcord.net/llms.txt
> Use this file to discover all available pages before exploring further.
# Sessions
> Host and manage BloxCord training/session events from in-game.
Session methods let a host start and run a session (training, raid, shift, etc.) entirely from inside the experience. All of them take an **actor** as the first argument (the host) and an **opts** table as the second.
A session is identified by its **session id** (`sid`), returned when you [start a session](#startsession). Pass that `sid` to every subsequent session method.
## getSessionReservations
Returns the sessions currently reserved/scheduled for your organization.
```lua theme={null}
local reservations = BloxCord:Invoke("getSessionReservations", actor)
```
### Parameters
The requesting host. See [the actor object](/gi-concepts#the-actor-object).
### Returns
An array of reservation records. Empty if there are none or the request failed.
***
## startSession
Starts hosting a session.
```lua theme={null}
local result = BloxCord:Invoke("startSession", actor, opts)
```
### Parameters
The host starting the session. See [the actor object](/gi-concepts#the-actor-object).
Session options.
The id of the session type to host.
The session mode.
Administration/config data for the session.
Whether the session is exclusive.
Optional scheduled time window for the session.
### Returns
The started-session payload (including its `sid`) on success, or `nil` on failure.
### Example
```lua theme={null}
local BloxCord = game:WaitForChild("BloxCord")
local session = BloxCord:Invoke("startSession", host, {
typeId = "training-basic",
mode = "on-demand",
exclusive = false,
})
local sid = session and session.sid
```
***
## sessionUpdateAttendees
Adds or removes attendees from a running session.
```lua theme={null}
local result = BloxCord:Invoke("sessionUpdateAttendees", actor, opts)
```
### Parameters
The host performing the update.
The session id.
Attendees to add.
Attendees to remove.
### Returns
The update result on success, or `nil` on failure.
***
## sessionUpdateMark
Sets or clears a phase mark for a specific attendee (e.g. marking a checkpoint as passed).
```lua theme={null}
local result = BloxCord:Invoke("sessionUpdateMark", actor, opts)
```
### Parameters
The host performing the update.
The session id.
The attendee's id.
The phase to mark.
The mark value.
### Returns
The update result on success, or `nil` on failure.
***
## sessionUpdateStrike
Adds or removes a strike against an attendee.
```lua theme={null}
local result = BloxCord:Invoke("sessionUpdateStrike", actor, opts)
```
### Parameters
The host performing the update.
The session id.
The attendee's id.
Either `"add"` or `"remove"`.
Reason for the strike (when adding).
The strike id (when removing).
### Returns
The update result on success, or `nil` on failure.
***
## sessionUpdatePhase
Adds, removes, or renames a phase within a session.
```lua theme={null}
local result = BloxCord:Invoke("sessionUpdatePhase", actor, opts)
```
### Parameters
The host performing the update.
The session id.
The phase action to perform.
The target phase id.
The phase name (for add/rename).
### Returns
The update result on success, or `nil` on failure.
***
## sessionUpdateSession
Transitions the session's state (e.g. moving it to a new status).
```lua theme={null}
local result = BloxCord:Invoke("sessionUpdateSession", actor, opts)
```
### Parameters
The host performing the update.
The session id.
The target state to transition to.
Optional reason for the transition.
### Returns
The update result on success, or `nil` on failure.
### Example
```lua theme={null}
local BloxCord = game:WaitForChild("BloxCord")
BloxCord:Invoke("sessionUpdateSession", host, {
sid = sid,
to = "ended",
reason = "Training complete",
})
```