The meeting object

{
  "id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "meeting",
  "workspace_id": "wks_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "source": "calendar_connection",
  "phase": "past",
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "platform": "meet",
  "organizer": {
    "name": "Marc",
    "email": "marc@gurusup.com",
    "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
  },
  "participants": [
    {
      "name": "Marc",
      "email": "marc@gurusup.com",
      "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
    },
    {
      "name": "Ana Ruiz",
      "email": "ana@acme.com",
      "member_id": null
    }
  ],
  "calendar_event": {
    "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "object": "calendar_event",
    "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "ical_uid": "7kq2b@google.com",
    "recurring": true,
    "title": "Weekly sync with Acme",
    "starts_at": "2026-09-29T09:00:00Z",
    "ends_at": "2026-09-29T09:30:00Z",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "organizer": { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab" },
    "attendees": [
      { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab", "response": "accepted" },
      { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
    ],
    "source": "calendar_connection",
    "metadata": {},
    "cancelled_at": null,
    "created_at": "2026-09-22T08:00:00Z",
    "updated_at": "2026-09-29T09:31:10Z"
  },
  "settings": {
    "recording": {
      "enabled": true,
      "methods": {
        "bot": {
          "start": "on_join",
          "mode": "audio_and_video",
          "silence_detection": {
            "alert": true
          }
        }
      }
    },
    "transcription": {
      "language": "auto"
    },
    "summary": {
      "template": "general_meeting_notes",
      "language": "same_as_transcript"
    },
    "branding": {
      "brand_kit_id": "none"
    },
    "sources": {
      "recording.enabled": { "assignment_id": "asg_01k6a3ext00000000000000000" },
      "recording.methods.bot.start": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.mode": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.silence_detection.alert": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "transcription.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "summary.template": { "assignment_id": null, "reason": "happyscribe_default" },
      "summary.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "branding.brand_kit_id": { "assignment_id": "asg_01k6a0wks00000000000000000" }
    },
    "assignments": [
      { "id": "asg_01k6a3ext00000000000000000", "settings_id": "set_01k6rec00000000000000000000", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab", "meetings:external"], "own": false },
      { "id": "asg_01k6a1ana00000000000000000", "settings_id": "set_01k6sa1es0000000000000000a", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab"], "own": false },
      { "id": "asg_01k6a0wks00000000000000000", "settings_id": "set_01k6wks00000000000000000000", "scope": ["workspace:wks_01k6a2r9s8x7c2dvq3m5n6p4ab"], "own": false }
    ]
  },
  "recordings": [
    {
      "id": "bot_01k6b0r9s8x7c2dvq3m5n6p4ab",
      "type": "bot",
      "status": "completed",
      "started_at": "2026-09-29T09:00:00Z",
      "ended_at": "2026-09-29T09:31:10Z"
    }
  ],
  "results": {
    "status": "ready",
    "transcript": {
      "status": "ready",
      "language": "en"
    },
    "summary": {
      "status": "ready"
    },
    "media": {
      "status": "ready",
      "duration_seconds": 1834.0
    }
  },
  "metadata": {},
  "created_at": "2026-09-22T10:14:03Z",
  "updated_at": "2026-09-29T09:41:10Z"
}

{
  "id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "meeting",
  "workspace_id": "wks_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "source": "calendar_connection",
  "phase": "past",
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "platform": "meet",
  "organizer": {
    "name": "Marc",
    "email": "marc@gurusup.com",
    "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
  },
  "participants": [
    {
      "name": "Marc",
      "email": "marc@gurusup.com",
      "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
    },
    {
      "name": "Ana Ruiz",
      "email": "ana@acme.com",
      "member_id": null
    }
  ],
  "calendar_event": {
    "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "object": "calendar_event",
    "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "ical_uid": "7kq2b@google.com",
    "recurring": true,
    "title": "Weekly sync with Acme",
    "starts_at": "2026-09-29T09:00:00Z",
    "ends_at": "2026-09-29T09:30:00Z",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "organizer": { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab" },
    "attendees": [
      { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab", "response": "accepted" },
      { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
    ],
    "source": "calendar_connection",
    "metadata": {},
    "cancelled_at": null,
    "created_at": "2026-09-22T08:00:00Z",
    "updated_at": "2026-09-29T09:31:10Z"
  },
  "settings": {
    "recording": {
      "enabled": true,
      "methods": {
        "bot": {
          "start": "on_join",
          "mode": "audio_and_video",
          "silence_detection": {
            "alert": true
          }
        }
      }
    },
    "transcription": {
      "language": "auto"
    },
    "summary": {
      "template": "general_meeting_notes",
      "language": "same_as_transcript"
    },
    "branding": {
      "brand_kit_id": "none"
    },
    "sources": {
      "recording.enabled": { "assignment_id": "asg_01k6a3ext00000000000000000" },
      "recording.methods.bot.start": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.mode": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.silence_detection.alert": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "transcription.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "summary.template": { "assignment_id": null, "reason": "happyscribe_default" },
      "summary.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "branding.brand_kit_id": { "assignment_id": "asg_01k6a0wks00000000000000000" }
    },
    "assignments": [
      { "id": "asg_01k6a3ext00000000000000000", "settings_id": "set_01k6rec00000000000000000000", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab", "meetings:external"], "own": false },
      { "id": "asg_01k6a1ana00000000000000000", "settings_id": "set_01k6sa1es0000000000000000a", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab"], "own": false },
      { "id": "asg_01k6a0wks00000000000000000", "settings_id": "set_01k6wks00000000000000000000", "scope": ["workspace:wks_01k6a2r9s8x7c2dvq3m5n6p4ab"], "own": false }
    ]
  },
  "recordings": [
    {
      "id": "bot_01k6b0r9s8x7c2dvq3m5n6p4ab",
      "type": "bot",
      "status": "completed",
      "started_at": "2026-09-29T09:00:00Z",
      "ended_at": "2026-09-29T09:31:10Z"
    }
  ],
  "results": {
    "status": "ready",
    "transcript": {
      "status": "ready",
      "language": "en"
    },
    "summary": {
      "status": "ready"
    },
    "media": {
      "status": "ready",
      "duration_seconds": 1834.0
    }
  },
  "metadata": {},
  "created_at": "2026-09-22T10:14:03Z",
  "updated_at": "2026-09-29T09:41:10Z"
}

A meeting is one real-world occurrence in one workspace. Its mtg_ id survives reschedules, a new link, recording changes and bot retries. See Meetings list.

Attributes

string

Beginning with mtg_. Stays the same through reschedules, URL changes and bot retries.

string

Always meeting.

string

Workspace ID, beginning with wks_. Treat it as an opaque string.

string

calendar_connection: From a calendar the member connected.
calendar_sync: From an event you pushed.
bot: From a bot you sent with POST /bots.

string

About time only; what happens after the call is in results.

upcoming: Not started, and nothing recording yet.
live: A recording is active. An early start counts: activity beats the calendar.
past: The recording ended, or the scheduled end went by.
cancelled: The calendar event was cancelled. Listed only when you ask for phase=cancelled.

string | null

The calendar event’s title, or a generated one for a bot sent without a calendar event.

string | null

A bot meeting starts at the bot’s join_at.

string | null

Scheduled end, or null when unknown.

string | null

The link to join the call, or null when the event has none.

string | null

The meeting platform, from the link. null for any other link (Webex, a dial-in page) or none.

meet: Google Meet.
zoom: Zoom.
teams: Microsoft Teams, Teams Live included.

object | null

Who organizes the meeting, or null when unknown.

Show properties

string | null

The person’s name, or null when unknown.

string | null

The person’s email, or null when unknown.

string | null

Set when the person is a member of the meeting’s workspace.

object[]

The people on the invite, or given when the bot was sent.

Show properties

string | null

The person’s name, or null when unknown.

string | null

The person’s email, or null when unknown.

string | null

Set when the person is a member of the meeting’s workspace.

object | null

The calendar event of this meeting, the object POST /calendar_events returns. null for bot meetings. See the calendar event object.

object

What applies to this meeting, which assignment supplied each value, and every assignment that reaches it. On GET /meetings, only with include=settings. See the settings block.

object[]

How audio came in. Each bot sent to the meeting, oldest first.

Show properties

string

The bot’s bot_ ID.

string

How the audio came in. Only bot for now.Available options: bot.

string

queued: Scheduled or waiting to join.
joining: Joining the call.
in_call: In the call and recording.
completed: Left the call; what it recorded is being or has been processed.
failed: Ended without a recording.
cancelled: Cancelled before it joined.

string | null

When the bot joined, or is scheduled to join.

string | null

When the bot left.

object

Statuses only. The content is at GET /meetings/{id}/results.

Show properties

string

The results as a whole.

processing: Being made.
ready: Done.
failed: It could not be made.
none: Nothing yet: no recording has produced it. It stays none when nothing was recorded, or when there is no transcript to summarize.

object

The transcript: its status and language.

Show properties

string

processing: Being made.
ready: Done.
failed: It could not be made.
none: Nothing yet: no recording has produced it. It stays none when nothing was recorded, or when there is no transcript to summarize.

string | null

The transcript’s language tag.

object

The summary: its status.

Show properties

string

processing: Being made.
ready: Done.
failed: It could not be made.
none: Nothing yet: no recording has produced it. It stays none when nothing was recorded, or when there is no transcript to summarize.

object

The recording: its status and length.

Show properties

string

processing: Being made.
ready: Done.
failed: It could not be made.
none: Nothing yet: no recording has produced it. It stays none when nothing was recorded, or when there is no transcript to summarize.

number | null

Length of the recording, in seconds.

object

Your key-value pairs on this meeting, set with PATCH /meetings/{id}. Never used to identify a meeting. See metadata.

string

When the meeting first appeared, in ISO 8601.

string

When anything in the meeting last changed, in ISO 8601.

{
  "id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "object": "meeting",
  "workspace_id": "wks_01k6a2r9s8x7c2dvq3m5n6p4ab",
  "source": "calendar_connection",
  "phase": "past",
  "title": "Weekly sync with Acme",
  "starts_at": "2026-09-29T09:00:00Z",
  "ends_at": "2026-09-29T09:30:00Z",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "platform": "meet",
  "organizer": {
    "name": "Marc",
    "email": "marc@gurusup.com",
    "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
  },
  "participants": [
    {
      "name": "Marc",
      "email": "marc@gurusup.com",
      "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab"
    },
    {
      "name": "Ana Ruiz",
      "email": "ana@acme.com",
      "member_id": null
    }
  ],
  "calendar_event": {
    "id": "cev_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "object": "calendar_event",
    "meeting_id": "mtg_01k6a2r9s8x7c2dvq3m5n6p4ab",
    "ical_uid": "7kq2b@google.com",
    "recurring": true,
    "title": "Weekly sync with Acme",
    "starts_at": "2026-09-29T09:00:00Z",
    "ends_at": "2026-09-29T09:30:00Z",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "organizer": { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab" },
    "attendees": [
      { "name": "Marc", "email": "marc@gurusup.com", "member_id": "mem_01k69x9s8x7c2dvq3m5n6p4ab", "response": "accepted" },
      { "name": "Ana Ruiz", "email": "ana@acme.com", "member_id": null, "response": "needs_action" }
    ],
    "source": "calendar_connection",
    "metadata": {},
    "cancelled_at": null,
    "created_at": "2026-09-22T08:00:00Z",
    "updated_at": "2026-09-29T09:31:10Z"
  },
  "settings": {
    "recording": {
      "enabled": true,
      "methods": {
        "bot": {
          "start": "on_join",
          "mode": "audio_and_video",
          "silence_detection": {
            "alert": true
          }
        }
      }
    },
    "transcription": {
      "language": "auto"
    },
    "summary": {
      "template": "general_meeting_notes",
      "language": "same_as_transcript"
    },
    "branding": {
      "brand_kit_id": "none"
    },
    "sources": {
      "recording.enabled": { "assignment_id": "asg_01k6a3ext00000000000000000" },
      "recording.methods.bot.start": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.mode": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "recording.methods.bot.silence_detection.alert": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "transcription.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "summary.template": { "assignment_id": null, "reason": "happyscribe_default" },
      "summary.language": { "assignment_id": "asg_01k6a1ana00000000000000000" },
      "branding.brand_kit_id": { "assignment_id": "asg_01k6a0wks00000000000000000" }
    },
    "assignments": [
      { "id": "asg_01k6a3ext00000000000000000", "settings_id": "set_01k6rec00000000000000000000", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab", "meetings:external"], "own": false },
      { "id": "asg_01k6a1ana00000000000000000", "settings_id": "set_01k6sa1es0000000000000000a", "scope": ["member:mem_01k69x9s8x7c2dvq3m5n6p4ab"], "own": false },
      { "id": "asg_01k6a0wks00000000000000000", "settings_id": "set_01k6wks00000000000000000000", "scope": ["workspace:wks_01k6a2r9s8x7c2dvq3m5n6p4ab"], "own": false }
    ]
  },
  "recordings": [
    {
      "id": "bot_01k6b0r9s8x7c2dvq3m5n6p4ab",
      "type": "bot",
      "status": "completed",
      "started_at": "2026-09-29T09:00:00Z",
      "ended_at": "2026-09-29T09:31:10Z"
    }
  ],
  "results": {
    "status": "ready",
    "transcript": {
      "status": "ready",
      "language": "en"
    },
    "summary": {
      "status": "ready"
    },
    "media": {
      "status": "ready",
      "duration_seconds": 1834.0
    }
  },
  "metadata": {},
  "created_at": "2026-09-22T10:14:03Z",
  "updated_at": "2026-09-29T09:41:10Z"
}

Overview

Endpoints

Attributes

​Attributes

Attributes