Rolebase Developers
API Reference

meeting_recurring

Defines the schedule, template, and settings for a recurring series of meetings within a circle.

Fields

FieldTypeDescription
iduuidUnique identifier for the recurring configuration
orgIduuidReference to the organization
circleIduuidReference to the circle
templateIduuidReference to the meeting template
rruleStringiCal (RFC 5545) format recurrence rule
durationSmallintMeeting duration in minutes
scopeparticipants_scopeConfiguration for participant selection
privateBooleanWhether meetings in the series are private (default: false)
invitedReadonlyBooleanWhether invited members are read-only (default: false)
videoConfJSONDefault video conferencing settings (optional)
createdAtTimestampWhen the recurring configuration was created

Relationships

Object Relationships:

  • org — The organization this recurring meeting belongs to
  • circle — The circle this recurring meeting is associated with
  • template — The meeting template used for each instance

Array Relationships:

  • meetings — Individual meeting instances in the recurring series

Recurrence Rule

The rrule field follows the iCalendar (RFC 5545) format. Examples:

  • FREQ=WEEKLY;BYDAY=MO — Every Monday
  • FREQ=WEEKLY;INTERVAL=2;BYDAY=TU,TH — Every two weeks on Tuesday and Thursday
  • FREQ=MONTHLY;BYMONTHDAY=1 — First day of each month

Query Examples

List Recurring Meetings

query MeetingRecurrings($orgId: uuid!) {
  meeting_recurring(where: { orgId: { _eq: $orgId } }) {
    id
    orgId
    circleId
    circle {
      role {
        name
        colorHue
      }
    }
    scope
    templateId
    template {
      title
      stepsConfig
    }
    rrule
    duration
    videoConf
    createdAt
    meetings {
      id
      recurringDate
    }
  }
}

Mutation Examples

Create a Recurring Meeting

mutation CreateMeetingRecurring {
  insert_meeting_recurring_one(
    object: {
      orgId: "org-id"
      circleId: "circle-id"
      templateId: "template-id"
      rrule: "FREQ=WEEKLY;INTERVAL=1;BYDAY=MO"
      duration: 60
      scope: { type: "circle_members" }
      private: false
      invitedReadonly: false
    }
  ) {
    id
    rrule
    duration
  }
}

Update a Recurring Meeting

mutation UpdateMeetingRecurring($id: uuid!) {
  update_meeting_recurring_by_pk(
    pk_columns: { id: $id }
    _set: { rrule: "FREQ=WEEKLY;INTERVAL=2;BYDAY=TU,TH", duration: 90 }
  ) {
    id
    rrule
    duration
  }
}

Permissions

  • Circle participants: Can create and manage recurring meetings in their circles
  • Organization members: Can view non-private recurring meetings
Info Circle Notes

Each recurring meeting must reference a template that defines its structure. Meeting instances are created automatically based on the recurrence rule. Changes to the configuration do not affect past meeting instances. The rrule field must follow the iCalendar specification.