URL: /code/apps/scheduling/update · Id: `page:/code/apps/scheduling/update`

# Meeting.update

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

PATCH https://api.sb/{your-domain}/meetings/{id}

Moves or changes a [Meeting](https://startupbuilder.dev/business/nouns/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

```text title="Run it · Ask"
Move Thursday’s Harborview call to 5pm UTC.
```

```ts title="Run it · SDK"
import { $ } from 'startup-builder'

const result = await $.try.Meeting.update({ id: 'meeting_Th4uR7sD2y', at: '2026-10-29T17:00:00Z' })
```

```json title="Run it · Response"
{
  "api": "https://api.sb/leaseline.app",
  "meeting": {
    "$id": "https://api.sb/leaseline.app/meetings/meeting_Th4uR7sD2y",
    "$type": "Meeting",
    "at": "2026-10-29T17:00:00Z"
  },
  "action": {
    "operation": "Meeting.update",
    "mode": "try",
    "status": "done"
  }
}
```

It extends the hub’s record call [`Meeting.update`](https://startupbuilder.dev/business/nouns/meeting/update), which every [Meeting](https://startupbuilder.dev/business/nouns/meeting) takes. It is one of the [Verbs](https://startupbuilder.dev/business/nouns/verb) of [Scheduling](/code/apps/scheduling#verbs).

## Inputs
| Name | Type | Meaning |
| --- | --- | --- |
| `id` | `string` | Required. The id of the Meeting. |
| `at` | `datetime` | When it starts. Optional. |
| `agenda` | `text` | What it covers. Optional. |
| `transcript` | `text` | What 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](https://startupbuilder.dev/business/nouns/meeting).

## Outputs
| Field | Type | What `null` means |
| --- | --- | --- |
| `meeting` | `Meeting` | Never 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
| Venue | Formats |
| --- | --- |
| [Google Calendar](/code/integrations/google-calendar#limits) | None. |

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
| Account | What try does |
| --- | --- |
| [Google Calendar](/code/integrations/google-calendar#try) | Reads 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](/code/refusals#accounts).

## 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.

**Ask**

```text
Move Thursday’s Harborview call to 5pm UTC.
```

**API**

```bash
curl -X PATCH "https://api.sb/leaseline.app/meetings/meeting_Th4uR7sD2y?mode=send" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "at": "2026-10-29T17:00:00Z"
}'
```

**CLI**

```bash
npx startup-builder do Meeting.update --send --data '{
  "at": "2026-10-29T17:00:00Z"
}'
```

`--send` returns the pending Action at once.

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "mode": "send",
    "code": "return await $.Meeting.update({ at: '2026-10-29T17:00:00Z' })"
  }
}
```

**SDK**

```ts
import { $ } from 'startup-builder'

const result = await $.send.Meeting.update({
  id: 'meeting_Th4uR7sD2y',
  at: '2026-10-29T17:00:00Z',
})
```


```json title="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
- **Integrations:** [Google Calendar](/code/integrations/google-calendar)

## Related
[`Meeting.book`](/code/apps/scheduling/book) · [`Meeting.create`](/code/apps/scheduling/create) · [`Meeting.list`](/code/apps/scheduling/list)