Skip to content
/
Auto-join rules
Last updated

Auto-join rules

Configure rules to automatically join Meeting Buddy to calendar events that match specific criteria.

GEThttps://api.aitronos.com/v1/meeting-buddy/auto-join/rules

List all auto-join rules for the authenticated user. Rules are evaluated in priority order (highest first) against upcoming calendar events.

Returns

Returns a list of auto-join rule objects with a total count.

Auto-Join Rule Object

FieldTypeDescription
idstringUnique rule ID (majr_ prefix)
namestringRule name
is_enabledbooleanWhether the rule is active
calendar_providerstring or nullLimit to specific provider
match_modestringMatch mode: all, keyword, organizer, custom
keywordsarray or nullKeywords to match in event title/description
organizer_emailsarray or nullOrganizer emails to match
exclude_patternsarray or nullPatterns to exclude events
min_attendeesintegerMinimum attendee count
max_attendeesinteger or nullMaximum attendee count
time_window_startstring or nullStart of allowed time window (HH:MM)
time_window_endstring or nullEnd of allowed time window (HH:MM)
days_of_weekarray or nullAllowed days (0=Monday, 6=Sunday)
timezonestringTimezone for time window evaluation
bot_namestring or nullCustom bot name for matched sessions
priorityintegerRule priority (higher = evaluated first)
created_atstringRule creation time (ISO 8601)
updated_atstringLast update time (ISO 8601)
cURL
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/auto-join/rules" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool

Create an auto-join rule

POSThttps://api.aitronos.com/v1/meeting-buddy/auto-join/rules

Create a new auto-join rule. The rule will be evaluated against upcoming calendar events to determine which meetings Meeting Buddy should automatically join.

Request Body

name string required

Rule name (max 255 characters).

match_mode string optional · Defaults to all

How to match events. Valid values: all (match all events), keyword (match by title/description keywords), organizer (match by organizer email), custom (combine multiple conditions).

keywords array optional

Keywords to match in event title or description. Required when match_mode is keyword or custom.

organizer_emails array optional

Organizer emails to match. Required when match_mode is organizer or custom.

exclude_patterns array optional

Patterns to exclude events (case-insensitive match against title and description).

calendar_provider string optional

Limit rule to a specific calendar provider.

min_attendees integer optional · Defaults to 0

Minimum number of attendees required.

max_attendees integer optional

Maximum number of attendees allowed.

time_window_start string optional

Start of allowed time window in HH:MM format (e.g., 09:00).

time_window_end string optional

End of allowed time window in HH:MM format (e.g., 17:00).

days_of_week array optional

Allowed days of the week (0=Monday through 6=Sunday).

timezone string optional · Defaults to UTC

Timezone for time window evaluation (e.g., US/Eastern, Europe/London).

bot_name string optional

Custom bot name for sessions created by this rule (max 100 characters).

priority integer optional · Defaults to 0

Rule priority. Higher values are evaluated first.

Returns

Returns the created Auto-Join Rule object with HTTP 201 status.

cURL
curl -s -X POST "https://api.aitronos.com/v1/meeting-buddy/auto-join/rules" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Join all standups",
    "match_mode": "keyword",
    "keywords": ["standup", "daily"],
    "exclude_patterns": ["1:1", "personal"],
    "min_attendees": 2,
    "time_window_start": "09:00",
    "time_window_end": "17:00",
    "days_of_week": [0, 1, 2, 3, 4],
    "timezone": "US/Eastern",
    "priority": 10
  }' | python3 -m json.tool

Update an auto-join rule

PATCHhttps://api.aitronos.com/v1/meeting-buddy/auto-join/rules/{rule_id}

Update an existing auto-join rule. Only provided fields are updated (partial update).

Path Parameters

rule_id string required

The auto-join rule ID (majr_ prefix).

Request Body

All fields from Create an auto-join rule are accepted, plus:

is_enabled boolean optional

Enable or disable the rule.

Returns

Returns the updated Auto-Join Rule object.

cURL
curl -s -X PATCH "https://api.aitronos.com/v1/meeting-buddy/auto-join/rules/majr_abc123def456" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"priority": 20, "is_enabled": false}' | python3 -m json.tool

Delete an auto-join rule

DELETEhttps://api.aitronos.com/v1/meeting-buddy/auto-join/rules/{rule_id}

Delete an auto-join rule. Events already scheduled by this rule are not affected.

Path Parameters

rule_id string required

The auto-join rule ID (majr_ prefix).

Returns

Returns no content on success (204).

cURL
curl -s -X DELETE "https://api.aitronos.com/v1/meeting-buddy/auto-join/rules/majr_abc123def456" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Previous page
Next page