Skip to content

Meeting.update

Moves or changes a Meeting and sends the new invite to everyone on it.

Action class
None
Approval
Runs on its own
Emits
Meeting.updated
Venues
Google Calendar
Price
Free
More factsFewer facts
PATCH https://api.sb/{your-domain}/meetings/{id}

It extends the hub’s record call Meeting.update, which every Meeting takes. It is one of the Verbs of Scheduling.

Inputs

NameTypeMeaning
idstringRequired. The id of the Meeting.
atdatetimeWhen it starts. Optional.
agendatextWhat it covers. Optional.
transcripttextWhat was said. Optional.

The hub inherits this call on every Noun: it takes the Meeting’s own Properties, listed on the hub’s Meeting page.

Outputs

FieldTypeWhat null means
meetingMeetingNever null: the Meeting as the call leaves it.

Effects

Action class

None: no approval rule names it, so it runs within its seat’s Permissions and Limits

Modes
  • try: Runs every check and returns the record as it would be; nothing is stored.
  • send: Returns a pending Action at once; Meeting.updated fires when it is done.
  • do: Waits for the Action to finish and returns the record.
Idempotency

Only with a key: the same Idempotency-Key and input return the first Action, and the same key with other input returns 409.

Saved or shared

The Meeting is saved as the call leaves it, with the Action that changed it.

Emits

Meeting.updated with { meeting }

Performed by

Whichever seat calls it

Price

Free on your own account: the platform charges nothing for the call.

On each Venue

VenueFormats
Google CalendarNone.

Each Venue’s caps, review and rate limits are on its integration page, linked from its row. A field marked Not sent is one that Venue has no place for; the call never fails on it.

What try does

AccountWhat try does
Google CalendarReads your free and busy times for real, picks the slot, and returns the invite it would send; nothing is written to your calendar.

Refuses when

The hub sets no guard of its own on this call: it refuses only on the shared checks every write meets (a missing record, a Permission the seat lacks).

Through a connected account it can also meet the shared account refusals.

When it waits

Returns in one response; nothing waits.

Example

In send mode the call returns its pending Action at once, and Meeting.updated delivers the result.

You, to your agent
Move Thursday’s Harborview call to 5pm UTC.
Response, in send mode
{
  "mode": "send",
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/action_Sd3kQ9vT2w",
    "operation": "Meeting.update",
    "status": "pending",
    "reason": "running"
  }
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

Used by