meeting

Fields

Field	Type	Description
id	uuid	Unique identifier for the meeting
orgId	uuid	Reference to the organization
circleId	uuid	Reference to the circle
title	String	Title of the meeting
summary	String	Summary or notes from the meeting
startDate	Timestamp	When the meeting starts
endDate	Timestamp	When the meeting ends
createdAt	Timestamp	When the meeting was created
ended	Boolean	Whether the meeting has ended (default: false)
archived	Boolean	Whether the meeting is archived (default: false)
private	Boolean	Whether the meeting is private (default: false)
invitedReadonly	Boolean	Whether invited members are read-only (default: false)
currentStepId	uuid	ID of the current active step (optional)
stepsConfig	[meeting_step_config]	Configuration array defining the meeting structure
videoConf	videoconf	Video conferencing details (optional)
recurringId	uuid	Reference to the recurring meeting configuration (optional)
recurringDate	Timestamp	Date in the recurring series (optional)

Relationships

Object Relationships:

• org — The organization this meeting belongs to
• circle — The circle this meeting is associated with
• recurring — The recurring meeting configuration (if part of a series)

Array Relationships:

• meeting_attendees — Members attending the meeting
• steps — Steps or agenda items in the meeting

Query Examples

List Meetings for an Organization

query GetMeetings($orgId: uuid!) {
  meeting(where: { archived: { _eq: false }, orgId: { _eq: $orgId } }) {
    id
    title
    startDate
    endDate
    ended
    circle {
      role {
        name
      }
    }
    meeting_attendees {
      member {
        name
      }
      present
    }
    steps {
      id
      data
    }
    videoConf
  }
}

Get a Specific Meeting

query GetMeeting($id: uuid!) {
  meeting_by_pk(id: $id) {
    id
    title
    startDate
    endDate
    circle {
      role {
        name
      }
    }
  }
}

Mutation Examples

Create a Meeting

mutation CreateMeeting {
  insert_meeting_one(
    object: {
      orgId: "your-org-id"
      circleId: "circle-id"
      title: "Weekly Team Sync"
      startDate: "2024-01-15T10:00:00Z"
      endDate: "2024-01-15T11:00:00Z"
      summary: "Team sync meeting"
      stepsConfig: [
        { id: "step-1", type: Tour, title: "Notes" }
        { id: "step-2", type: Threads, title: "Topics" }
        { id: "step-3", type: Checklist, title: "Checklist" }
        { id: "step-4", type: Indicators, title: "Indicators" }
        { id: "step-5", type: Tasks, title: "Tasks" }
      ]
      private: false
      invitedReadonly: false
      meeting_attendees: {
        data: [{ memberId: "member-id-1" }, { memberId: "member-id-2" }]
      }
    }
  ) {
    id
    title
    startDate
  }
}

Update Meeting Status

mutation UpdateMeeting {
  update_meeting_by_pk(
    pk_columns: { id: "meeting-id" }
    _set: { ended: true, summary: "Meeting notes and outcomes..." }
  ) {
    id
    ended
    summary
  }
}

Permissions

Meeting access is controlled by multiple factors:

• Circle participants: Can access and manage their circle’s meetings
• Private meetings: Only visible to circle participants and invited attendees
• Organization members: Can access non-private meetings
• Invited attendees: Can participate based on the invitedReadonly setting