@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/meetings.md

@@ -0,0 +1,747 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.meetings`: Meetings
+
+17 operations (10 read, 3 write, 1 destructive, 3 billable).
+
+2 of these also have a hand-written method (`g8.meetings`), marked **★** below. Prefer the hand-written method when one exists: it unwraps the `data` envelope and takes friendlier arguments. See [../sdk-clients.md](../sdk-clients.md).
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [meetings.d.ts](meetings.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`acknowledgeMeetingReview`](#op-acknowledgemeetingreview) | `POST /api/v1/meeting-transcripts/{transcript_id}/review/acknowledge` | write | `meetings:write` | Acknowledge Meeting Review |
+| [`advanceDealStage`](#op-advancedealstage) | `POST /api/v1/deals/{deal_id}/advance-stage` | write | `meetings:write` | Advance Deal Stage |
+| [`deleteMeetingTranscript`](#op-deletemeetingtranscript) | `DELETE /api/v1/meeting-transcripts/{transcript_id}` | destructive | `meetings:delete` | Delete Meeting Transcript |
+| [`draftMeetingFollowUp`](#op-draftmeetingfollowup) | `POST /api/v1/meeting-transcripts/{transcript_id}/follow-up-draft` | billable | `meetings:run` | Draft Meeting Follow Up |
+| [`getDealMemory`](#op-getdealmemory) | `GET /api/v1/deals/{deal_id}/memory` | read | `meetings:read` | Get Deal Memory |
+| [`getDealStageReadiness`](#op-getdealstagereadiness) | `GET /api/v1/deals/{deal_id}/stage-readiness` | read | `meetings:read` | Get Deal Stage Readiness |
+| [`getMeeting`](#op-getmeeting) ★ | `GET /api/v1/inbox/meetings/{meeting_id}` | read | `meetings:read` | Get Meeting |
+| [`getMeetingCoachingQueue`](#op-getmeetingcoachingqueue) | `GET /api/v1/meeting-transcripts/coaching-queue` | read | `meetings:read` | Get Meeting Coaching Queue |
+| [`getMeetingReview`](#op-getmeetingreview) | `GET /api/v1/meeting-transcripts/{transcript_id}/review` | read | `meetings:read` | Get Meeting Review |
+| [`getMeetingTranscript`](#op-getmeetingtranscript) | `GET /api/v1/meeting-transcripts/{transcript_id}` | read | `meetings:read` | Get Meeting Transcript |
+| [`getMeetingTranscriptStats`](#op-getmeetingtranscriptstats) | `GET /api/v1/meeting-transcripts/stats` | read | `meetings:read` | Get Meeting Transcript Stats |
+| [`linkMeetingTranscriptAccount`](#op-linkmeetingtranscriptaccount) | `PATCH /api/v1/meeting-transcripts/{transcript_id}/account` | write | `meetings:write` | Link Meeting Transcript Account |
+| [`listMeetingTranscripts`](#op-listmeetingtranscripts) | `GET /api/v1/meeting-transcripts` | read | `meetings:read` | List Meeting Transcripts |
+| [`listMeetings`](#op-listmeetings) ★ | `GET /api/v1/inbox/meetings` | read | `meetings:read` | List Meetings |
+| [`meetingsBooked`](#op-meetingsbooked) | `GET /api/v1/inbox/meetings/booked` | read | `meetings:read` | Meetings Booked |
+| [`regenerateMeetingReview`](#op-regeneratemeetingreview) | `POST /api/v1/meeting-transcripts/{transcript_id}/review/regenerate` | billable | `meetings:run` | Regenerate Meeting Review |
+| [`suggestDealNextBestStep`](#op-suggestdealnextbeststep) | `POST /api/v1/deals/{deal_id}/next-best-step` | billable | `meetings:run` | Suggest Deal Next Best Step |
+
+---
+
+<a id="op-acknowledgemeetingreview"></a>
+
+### `g8.api.meetings.acknowledgeMeetingReview(input)`
+
+**Acknowledge Meeting Review**
+
+- HTTP: `POST /api/v1/meeting-transcripts/{transcript_id}/review/acknowledge`
+- operationId: `acknowledge_meeting_review_meeting_transcripts__transcript_id__review_acknowledge_post` (also callable as `g8.api.call("acknowledge_meeting_review_meeting_transcripts__transcript_id__review_acknowledge_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Mark a review acknowledged in the coaching queue. MANAGER ONLY.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.acknowledgeMeetingReview({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-advancedealstage"></a>
+
+### `g8.api.meetings.advanceDealStage(input)`
+
+**Advance Deal Stage**
+
+- HTTP: `POST /api/v1/deals/{deal_id}/advance-stage`
+- operationId: `advance_deal_stage_deals__deal_id__advance_stage_post` (also callable as `g8.api.call("advance_deal_stage_deals__deal_id__advance_stage_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+Move the deal to its next stage when the meeting evidence says it is ready.
+
+A real stage change: audited, and it emits the same stage-change event a
+person moving the deal would. Refused when the readiness check fails.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.deal_id` | `string` | yes | Deal id (UUID). |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.advanceDealStage({ path: { deal_id: "id" } });
+```
+
+---
+
+<a id="op-deletemeetingtranscript"></a>
+
+### `g8.api.meetings.deleteMeetingTranscript(input)`
+
+**Delete Meeting Transcript**
+
+- HTTP: `DELETE /api/v1/meeting-transcripts/{transcript_id}`
+- operationId: `delete_meeting_transcript_meeting_transcripts__transcript_id__delete` (also callable as `g8.api.call("delete_meeting_transcript_meeting_transcripts__transcript_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `meetings:delete`
+
+Delete a transcript PERMANENTLY. ORG ADMIN ONLY (checked by the app handler).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.meetings.deleteMeetingTranscript({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-draftmeetingfollowup"></a>
+
+### `g8.api.meetings.draftMeetingFollowUp(input)`
+
+**Draft Meeting Follow Up**
+
+- HTTP: `POST /api/v1/meeting-transcripts/{transcript_id}/follow-up-draft`
+- operationId: `draft_meeting_follow_up_meeting_transcripts__transcript_id__follow_up_draft_post` (also callable as `g8.api.call("draft_meeting_follow_up_meeting_transcripts__transcript_id__follow_up_draft_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `meetings:run`
+
+A follow-up email draft grounded in this meeting. NOTHING IS SENT.
+
+Returns the draft written at import time when there is one; generates on
+demand (a model call, which spends credits) when there is none or when
+`regenerate=true`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+| `query.regenerate` | `boolean` | no | Write a fresh draft even when one is stored. SPENDS CREDITS. default `false` |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.meetings.draftMeetingFollowUp({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-getdealmemory"></a>
+
+### `g8.api.meetings.getDealMemory(input)`
+
+**Get Deal Memory**
+
+- HTTP: `GET /api/v1/deals/{deal_id}/memory`
+- operationId: `get_deal_memory_deals__deal_id__memory_get` (also callable as `g8.api.call("get_deal_memory_deals__deal_id__memory_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Everything the meetings on this deal established: people, pains, commitments, risks.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.deal_id` | `string` | yes | Deal id (UUID). |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getDealMemory({ path: { deal_id: "id" } });
+```
+
+---
+
+<a id="op-getdealstagereadiness"></a>
+
+### `g8.api.meetings.getDealStageReadiness(input)`
+
+**Get Deal Stage Readiness**
+
+- HTTP: `GET /api/v1/deals/{deal_id}/stage-readiness`
+- operationId: `get_deal_stage_readiness_deals__deal_id__stage_readiness_get` (also callable as `g8.api.call("get_deal_stage_readiness_deals__deal_id__stage_readiness_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+How ready this deal is for its next stage, from the evidence in its meeting reviews.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.deal_id` | `string` | yes | Deal id (UUID). |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getDealStageReadiness({ path: { deal_id: "id" } });
+```
+
+---
+
+<a id="op-getmeeting"></a>
+
+### `g8.api.meetings.getMeeting(input)`
+
+**Get Meeting**
+
+- HTTP: `GET /api/v1/inbox/meetings/{meeting_id}`
+- operationId: `get_meeting_inbox_meetings__meeting_id__get` (also callable as `g8.api.call("get_meeting_inbox_meetings__meeting_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+- ★ Hand-written: [`g8.meetings.get()`](../sdk-clients.md#g8-meetings-get)
+
+Get a single meeting by ID with full transcript bundled inline.
+
+Transcript content is included when the caller is a participant or
+has the `meetings:see_transcripts` permission. Otherwise the response
+sets `transcript_redacted=true` and omits the transcript body
+(status / IDs remain visible).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.meeting_id` | `string` | yes | Meeting ID (CalendarEvent.id) |
+
+**Returns** `ApiResponse_MeetingDetail_`: the envelope `{ data: MeetingDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`MeetingDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `action_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `assignees` | `Array<Record<string, unknown>>` | no |  |
+| `attendees` | `Array<MeetingAttendee>` | no |  |
+| `audience_type` | `string \| null` | no |  |
+| `campaign_mentions` | `Array<string> \| null` | no |  |
+| `channel` | `string` | no | default `"meetings"` |
+| `created_at` | `string \| null` | no |  |
+| `custom_fields` | `Array<Record<string, unknown>> \| null` | no |  |
+| `end_time` | `string \| null` | no |  |
+| `is_internal_only` | `boolean \| null` | no |  |
+| `key_topics` | `Array<string> \| null` | no |  |
+| `matched_account` | `Record<string, unknown> \| null` | no |  |
+| `meeting_sensitivity` | `string \| null` | no |  |
+| `meeting_tasks` | `Array<Record<string, unknown>> \| null` | no | CRM tasks created from transcript action items |
+| `meeting_url` | `string \| null` | no |  |
+| `organizer_email` | `string \| null` | no |  |
+| `organizer_team_member` | `Record<string, unknown> \| null` | no |  |
+| `owner_team_member` | `Record<string, unknown> \| null` | no |  |
+| `participant_links` | `Array<Record<string, unknown>> \| null` | no |  |
+| `start_time` | `string \| null` | no |  |
+| `subject` | `string \| null` | no |  |
+| `tags` | `Array<Record<string, unknown>>` | no |  |
+| `transcript_id` | `string \| null` | no |  |
+| `transcript_link_source` | `string \| null` | no |  |
+| `transcript_redacted` | `boolean` | no | default `false` |
+| `transcript_source` | `string \| null` | no |  |
+| `transcript_status` | `string \| null` | no |  |
+| `transcript_summary` | `string \| null` | no |  |
+| `transcript_text` | `string \| null` | no | Full transcript body text (omitted when redacted) |
+| `updated_at` | `string \| null` | no |  |
+| `user_email` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getMeeting({ path: { meeting_id: "id" } });
+```
+
+---
+
+<a id="op-getmeetingcoachingqueue"></a>
+
+### `g8.api.meetings.getMeetingCoachingQueue(input?)`
+
+**Get Meeting Coaching Queue**
+
+- HTTP: `GET /api/v1/meeting-transcripts/coaching-queue`
+- operationId: `get_meeting_coaching_queue_meeting_transcripts_coaching_queue_get` (also callable as `g8.api.call("get_meeting_coaching_queue_meeting_transcripts_coaching_queue_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Reviewed meetings flagged for a manager's attention. MANAGER ONLY.
+
+Requires `meetings:see_all` or a privileged org role on the key's minter;
+otherwise 403, because it surfaces every rep's scores.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.target` | `string \| null` | no | Only reviews for this pipeline target. |
+| `query.only_unreviewed` | `boolean` | no | Only reviews no manager has acknowledged. default `false` |
+| `query.min_score` | `integer` | no | Lowest review score to include. default `0` |
+| `query.max_score` | `integer` | no | Highest review score to include. default `40` |
+| `query.limit` | `integer` | no | How many reviews. default `50` |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getMeetingCoachingQueue();
+```
+
+---
+
+<a id="op-getmeetingreview"></a>
+
+### `g8.api.meetings.getMeetingReview(input)`
+
+**Get Meeting Review**
+
+- HTTP: `GET /api/v1/meeting-transcripts/{transcript_id}/review`
+- operationId: `get_meeting_review_meeting_transcripts__transcript_id__review_get` (also callable as `g8.api.call("get_meeting_review_meeting_transcripts__transcript_id__review_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The AI review of this meeting: score, stage elements hit and missed, coaching notes.
+
+404 until the review has run. A review that ran but was skipped (orphan
+meeting, transcript too short) returns `skipped: true` with the reason.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getMeetingReview({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-getmeetingtranscript"></a>
+
+### `g8.api.meetings.getMeetingTranscript(input)`
+
+**Get Meeting Transcript**
+
+- HTTP: `GET /api/v1/meeting-transcripts/{transcript_id}`
+- operationId: `get_meeting_transcript_meeting_transcripts__transcript_id__get` (also callable as `g8.api.call("get_meeting_transcript_meeting_transcripts__transcript_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+The full transcript. 403 unless the key's minter took part or can see all meetings.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getMeetingTranscript({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-getmeetingtranscriptstats"></a>
+
+### `g8.api.meetings.getMeetingTranscriptStats(input?)`
+
+**Get Meeting Transcript Stats**
+
+- HTTP: `GET /api/v1/meeting-transcripts/stats`
+- operationId: `get_meeting_transcript_stats_meeting_transcripts_stats_get` (also callable as `g8.api.call("get_meeting_transcript_stats_meeting_transcripts_stats_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Org-wide counts: transcripts by type, how many are filed, recent volume.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.getMeetingTranscriptStats();
+```
+
+---
+
+<a id="op-linkmeetingtranscriptaccount"></a>
+
+### `g8.api.meetings.linkMeetingTranscriptAccount(input)`
+
+**Link Meeting Transcript Account**
+
+- HTTP: `PATCH /api/v1/meeting-transcripts/{transcript_id}/account`
+- operationId: `link_meeting_transcript_account_meeting_transcripts__transcript_id__account_patch` (also callable as `g8.api.call("link_meeting_transcript_account_meeting_transcripts__transcript_id__account_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `meetings:write`
+
+File this transcript under an account, overriding the automatic categoriser.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+| `body` | `LinkTranscriptAccountRequest` | yes | Request body; fields below. |
+
+Body fields (`LinkTranscriptAccountRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.account_id` | `string` | yes | Account (company) to file the transcript under. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.linkMeetingTranscriptAccount({ path: { transcript_id: "id" }, body: { account_id: "id" } });
+```
+
+---
+
+<a id="op-listmeetingtranscripts"></a>
+
+### `g8.api.meetings.listMeetingTranscripts(input?)`
+
+**List Meeting Transcripts**
+
+- HTTP: `GET /api/v1/meeting-transcripts`
+- operationId: `list_meeting_transcripts_meeting_transcripts_get` (also callable as `g8.api.call("list_meeting_transcripts_meeting_transcripts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Transcripts the key can see, newest first, with a total for paging.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.transcript_type` | `string \| null` | no | `account`, `client` or `internal`. |
+| `query.account_id` | `string \| null` | no | Only transcripts filed under this account. |
+| `query.date_from` | `string (date) \| null` | no | Earliest meeting date. |
+| `query.date_to` | `string (date) \| null` | no | Latest meeting date. |
+| `query.search` | `string \| null` | no | Match in the title or the transcript text. |
+| `query.limit` | `integer` | no | Page size. default `50` |
+| `query.offset` | `integer` | no | Rows to skip. default `0` |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.listMeetingTranscripts();
+```
+
+---
+
+<a id="op-listmeetings"></a>
+
+### `g8.api.meetings.listMeetings(input?)`
+
+**List Meetings**
+
+- HTTP: `GET /api/v1/inbox/meetings`
+- operationId: `list_meetings_inbox_meetings_get` (also callable as `g8.api.call("list_meetings_inbox_meetings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+- ★ Hand-written: [`g8.meetings.list()`](../sdk-clients.md#g8-meetings-list)
+
+List meetings as compact summary cards.
+
+The default visibility scope follows the caller's RBAC. Pass
+`participant_email` to scope down to a specific contact's meetings
+(matched across organizer + owner + attendees). Transcript content
+is returned only as a short summary preview; call the detail
+endpoint for full transcript text.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.participant_email` | `Array<string> \| null` | no | Filter to meetings where ANY of the provided emails appears as organizer, owner, or attendee (case-insensitive, OR-matched). Repeat the param for multiple emails. |
+| `query.scope` | `string \| null` | no | Visibility scope: 'my' (your meetings) or 'all' (org-wide, requires meetings:see_all) |
+| `query.timeframe` | `string \| null` | no | 'all', 'upcoming', or 'past' (default: past) |
+| `query.has_transcript` | `boolean \| null` | no | True = transcript linked; False = no transcript |
+| `query.internal_mode` | `string \| null` | no | Internal meeting visibility. 'include_internal' returns ALL meetings (team syncs, internal-only attendees). 'exclude_internal' drops any meeting with no external attendees. Omitting respects the org policy default (most orgs default to exclude_internal). Pass include_internal to see team/standup meetings the default would hide. |
+| `query.search` | `string \| null` | no | Match title or transcript text |
+| `query.page` | `integer` | no | Page number default `1` |
+| `query.page_size` | `integer` | no | Items per page default `50` |
+
+**Returns** `ApiResponse_list_MeetingSummary__`: the envelope `{ data: Array<MeetingSummary>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`MeetingSummary` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `assignees` | `Array<Record<string, unknown>>` | no |  |
+| `attendees` | `Array<MeetingAttendee>` | no |  |
+| `audience_type` | `string \| null` | no | customer, prospect, internal, or unknown |
+| `channel` | `string` | no | default `"meetings"` |
+| `created_at` | `string \| null` | no |  |
+| `end_time` | `string \| null` | no |  |
+| `is_internal_only` | `boolean \| null` | no |  |
+| `matched_account` | `Record<string, unknown> \| null` | no |  |
+| `meeting_sensitivity` | `string \| null` | no |  |
+| `meeting_url` | `string \| null` | no |  |
+| `organizer_email` | `string \| null` | no |  |
+| `preview` | `string \| null` | no | Short conversational summary for inbox-card rendering |
+| `start_time` | `string \| null` | no |  |
+| `subject` | `string \| null` | no | Meeting title |
+| `tags` | `Array<Record<string, unknown>>` | no |  |
+| `transcript_id` | `string \| null` | no |  |
+| `transcript_redacted` | `boolean` | no | True when transcript content is hidden due to lack of permissions default `false` |
+| `transcript_source` | `string \| null` | no |  |
+| `transcript_status` | `string \| null` | no | linked, missing, or no_transcript_expected |
+| `transcript_summary` | `string \| null` | no | Short transcript summary (preview only) |
+| `updated_at` | `string \| null` | no |  |
+| `user_email` | `string \| null` | no | Calendar owner email (the user this meeting belongs to) |
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.listMeetings();
+```
+
+---
+
+<a id="op-meetingsbooked"></a>
+
+### `g8.api.meetings.meetingsBooked(input?)`
+
+**Meetings Booked**
+
+- HTTP: `GET /api/v1/inbox/meetings/booked`
+- operationId: `meetings_booked_inbox_meetings_booked_get` (also callable as `g8.api.call("meetings_booked_inbox_meetings_booked_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `meetings:read`
+
+Count + recent list of booked meetings (not cancelled, not deleted,
+not private-sensitivity).
+
+Org-scoped to the authenticated key's organization. Returns metadata
+only (title / time / status / attendee count) — never transcript
+content. Finer per-user / `meetings:see_all` scoping is tracked as a
+follow-up. Registered before `/{meeting_id}` so 'booked' isn't captured
+as an id.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.days` | `integer` | no | Lookback window in days default `30` |
+| `query.limit` | `integer` | no | Max meetings per page default `20` |
+| `query.page` | `integer` | no | 1-based page over the booked list default `1` |
+| `query.upcoming_only` | `boolean` | no | Only meetings from now forward default `false` |
+
+**Returns** `ApiResponse_MeetingsBookedResult_`: the envelope `{ data: MeetingsBookedResult, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`MeetingsBookedResult` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `days` | `integer` | yes |  |
+| `count` | `integer` | no | Total booked meetings in the window default `0` |
+| `has_next` | `boolean` | no | Whether another page exists default `false` |
+| `meetings` | `Array<BookedMeeting>` | no |  |
+| `page` | `integer` | no | 1-based page of the booked list default `1` |
+| `upcoming_only` | `boolean` | no | default `false` |
+
+**Example**
+
+```ts
+const result = await g8.api.meetings.meetingsBooked();
+```
+
+---
+
+<a id="op-regeneratemeetingreview"></a>
+
+### `g8.api.meetings.regenerateMeetingReview(input)`
+
+**Regenerate Meeting Review**
+
+- HTTP: `POST /api/v1/meeting-transcripts/{transcript_id}/review/regenerate`
+- operationId: `regenerate_meeting_review_meeting_transcripts__transcript_id__review_regenerate_post` (also callable as `g8.api.call("regenerate_meeting_review_meeting_transcripts__transcript_id__review_regenerate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `meetings:run`
+
+Run the meeting review again. SPENDS CREDITS on every call.
+
+For a review that failed, or after the transcript was re-linked to the
+right deal.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.transcript_id` | `string` | yes | Transcript id. |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.meetings.regenerateMeetingReview({ path: { transcript_id: "id" } });
+```
+
+---
+
+<a id="op-suggestdealnextbeststep"></a>
+
+### `g8.api.meetings.suggestDealNextBestStep(input)`
+
+**Suggest Deal Next Best Step**
+
+- HTTP: `POST /api/v1/deals/{deal_id}/next-best-step`
+- operationId: `suggest_deal_next_best_step_deals__deal_id__next_best_step_post` (also callable as `g8.api.call("suggest_deal_next_best_step_deals__deal_id__next_best_step_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `meetings:run`
+
+One recommended next action for this deal. SPENDS CREDITS. Writes nothing.
+
+POST because every call is a fresh model call. Gated on READ access to
+the deal, as in the app: recommending is not editing. 502 when the model
+call fails.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.deal_id` | `string` | yes | Deal id (UUID). |
+
+**Returns** `ApiResponse_CrmRecordPayload_`: the envelope `{ data: CrmRecordPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.meetings.suggestDealNextBestStep({ path: { deal_id: "id" } });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-bookedmeeting"></a>
+
+### `BookedMeeting`
+
+One booked calendar meeting (non-cancelled, non-private).
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `attendees` | `integer` | no | Attendee count default `0` |
+| `end_time` | `string \| null` | no |  |
+| `organizer` | `string \| null` | no |  |
+| `start_time` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+<a id="type-meetingattendee"></a>
+
+### `MeetingAttendee`
+
+Lightweight attendee record on a meeting.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `email` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `organizer` | `boolean \| null` | no | True when this attendee is the meeting organizer |
+| `response_status` | `string \| null` | no | Provider-reported RSVP: accepted, declined, tentative, needsAction |