Proposed Slots

Proposed slots are time options for a board meeting that participants vote on. They enable collaborative scheduling — members propose times, vote on availability, and the organizer confirms the winning slot as the meeting time.

Relationship to Meetings

Every proposed slot belongs to exactly one meeting. All endpoints are nested under a meeting.

Endpoints

Proposed Slot Object

{
  "object": "proposed_slot",
  "id": "60d5ec49f1a2c8b1f8e4e1c1",
  "meetingId": "60d5ec49f1a2c8b1f8e4e1b1",
  "createdByUserId": "507f1f77bcf86cd799439011",
  "startTime": "2025-07-15T14:00:00.000Z",
  "timezone": "America/New_York",
  "durationInMinutes": 120,
  "feedbacks": [
    {
      "userId": "507f1f77bcf86cd799439011",
      "vote": "ok",
      "comment": null,
      "email": null,
      "isGuest": false
    },
    {
      "userId": null,
      "vote": "challenging",
      "comment": "Tight but can make it",
      "email": "[email protected]",
      "isGuest": true
    }
  ],
  "createdAt": "2025-06-01T10:00:00.000Z",
  "updatedAt": "2025-06-10T09:30:00.000Z"
}

Fields

Feedback Object

Vote Values

List Proposed Slots

GET /api/v1/boards/:boardId/meetings/:meetingId/slots

Returns all proposed time slots for a meeting. Feedbacks are filtered to include only current board members plus any guest votes.

Response

{
  "data": [
    /* array of proposed slot objects */
  ],
  "meta": { "nextCursor": null, "hasMore": false }
}

Errors

Create a Proposed Slot

POST /api/v1/boards/:boardId/meetings/:meetingId/slots

Proposes a new time slot. The creator is automatically marked as ok. All other board members start as didNotVote. Requires at least collaborator access.

Request Body

Only startTime, timezone, and durationInMinutes are accepted — unknown fields are rejected.

Response

Returns 201 with the created proposed slot object wrapped in { "data": ... }.

Errors

Vote on a Slot

PUT /api/v1/boards/:boardId/meetings/:meetingId/slots/:slotId/vote

Casts or updates the authenticated user's vote on a proposed slot. Only vote and comment are accepted.

Request Body

Response

Returns the updated proposed slot object wrapped in { "data": ... }.

Errors

Delete a Slot

DELETE /api/v1/boards/:boardId/meetings/:meetingId/slots/:slotId

Removes a proposed time slot.

Response

{ "data": { "deleted": true } }

Errors

Confirm Slot as Meeting Time

POST /api/v1/boards/:boardId/meetings/:meetingId/slots/:slotId/confirm

Confirms a proposed slot as the meeting's scheduled time. Copies the slot's start time, duration, and timezone to the meeting.

Response

Returns the updated meeting object (see Meetings).

Errors