@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/salesCoach.md

@@ -0,0 +1,1540 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.salesCoach`: Sales Coach
+
+37 operations (20 read, 10 write, 5 destructive, 2 external).
+
+No hand-written client covers this area. Call it through `g8.api.salesCoach.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+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: [salesCoach.d.ts](salesCoach.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addInterviewMember`](#op-addinterviewmember) | `POST /api/v1/sales-coach/interviews/{interview_id}/members` | external | `team:run` | Add Interview Member |
+| [`assignTeamRole`](#op-assignteamrole) | `PUT /api/v1/sales-coach/team/users/{user_id}/role` | destructive | `team:delete` | Assign Team Role |
+| [`createCall`](#op-createcall) | `POST /api/v1/sales-coach/calls` | write | `team:write` | Create Call |
+| [`createInterview`](#op-createinterview) | `POST /api/v1/sales-coach/interviews` | write | `team:write` | Create Interview |
+| [`createInterviewAttempt`](#op-createinterviewattempt) | `POST /api/v1/sales-coach/interview-attempts` | write | `team:write` | Create Interview Attempt |
+| [`createInterviewAttemptByCode`](#op-createinterviewattemptbycode) | `POST /api/v1/sales-coach/interview-attempts/by-code/{code}` | write | `team:write` | Create Interview Attempt By Code |
+| [`createTeamLeaderboard`](#op-createteamleaderboard) | `POST /api/v1/sales-coach/team/leaderboards` | write | `team:write` | Create Team Leaderboard |
+| [`createTeamSet`](#op-createteamset) | `POST /api/v1/sales-coach/team/sets` | write | `team:write` | Create Team Set |
+| [`deleteCall`](#op-deletecall) | `DELETE /api/v1/sales-coach/calls/{call_id}` | destructive | `team:delete` | Delete Call |
+| [`deleteInterview`](#op-deleteinterview) | `DELETE /api/v1/sales-coach/interviews/{interview_id}` | destructive | `team:delete` | Delete Interview |
+| [`deleteTeamLeaderboard`](#op-deleteteamleaderboard) | `DELETE /api/v1/sales-coach/team/leaderboards/{lb_id}` | destructive | `team:delete` | Delete Team Leaderboard |
+| [`deleteTeamSet`](#op-deleteteamset) | `DELETE /api/v1/sales-coach/team/sets/{set_id}` | destructive | `team:delete` | Delete Team Set |
+| [`getCall`](#op-getcall) | `GET /api/v1/sales-coach/calls/{call_id}` | read | `team:read` | Get Call |
+| [`getCallAudioUrl`](#op-getcallaudiourl) | `GET /api/v1/sales-coach/calls/{call_id}/audio-url` | read | `team:read` | Get Call Audio Url |
+| [`getCallTranscript`](#op-getcalltranscript) | `GET /api/v1/sales-coach/calls/{call_id}/transcript` | read | `team:read` | Get Call Transcript |
+| [`getInterview`](#op-getinterview) | `GET /api/v1/sales-coach/interviews/{interview_id}` | read | `team:read` | Get Interview |
+| [`getInterviewByCode`](#op-getinterviewbycode) | `GET /api/v1/sales-coach/interviews/by-code/{code}` | read | `team:read` | Get Interview By Code |
+| [`getSalesCoachLeaderboard`](#op-getsalescoachleaderboard) | `GET /api/v1/sales-coach/leaderboard` | read | `team:read` | Get Sales Coach Leaderboard |
+| [`getTeamActiveUsersSummary`](#op-getteamactiveuserssummary) | `GET /api/v1/sales-coach/team/active-users-summary` | read | `team:read` | Get Team Active Users Summary |
+| [`getTeamBootstrap`](#op-getteambootstrap) | `GET /api/v1/sales-coach/team/bootstrap` | read | `team:read` | Get Team Bootstrap |
+| [`getTeamConfig`](#op-getteamconfig) | `GET /api/v1/sales-coach/team/config` | read | `team:read` | Get Team Config |
+| [`getTeamKpiCatalog`](#op-getteamkpicatalog) | `GET /api/v1/sales-coach/team/kpi-catalog` | read | `team:read` | Get Team Kpi Catalog |
+| [`getTeamLeaderboardData`](#op-getteamleaderboarddata) | `GET /api/v1/sales-coach/team/leaderboards/{lb_id}/data` | read | `team:read` | Get Team Leaderboard Data |
+| [`getTeamSetData`](#op-getteamsetdata) | `GET /api/v1/sales-coach/team/sets/{set_id}/data` | read | `team:read` | Get Team Set Data |
+| [`listCalls`](#op-listcalls) | `GET /api/v1/sales-coach/calls` | read | `team:read` | List Calls |
+| [`listCoachContactLists`](#op-listcoachcontactlists) | `GET /api/v1/sales-coach/contact-lists` | read | `team:read` | List Coach Contact Lists |
+| [`listInterviewAttempts`](#op-listinterviewattempts) | `GET /api/v1/sales-coach/interview-attempts` | read | `team:read` | List Interview Attempts |
+| [`listInterviews`](#op-listinterviews) | `GET /api/v1/sales-coach/interviews` | read | `team:read` | List Interviews |
+| [`listTeamLeaderboards`](#op-listteamleaderboards) | `GET /api/v1/sales-coach/team/leaderboards` | read | `team:read` | List Team Leaderboards |
+| [`listTeamRoles`](#op-listteamroles) | `GET /api/v1/sales-coach/team/roles` | read | `team:read` | List Team Roles |
+| [`listTeamSets`](#op-listteamsets) | `GET /api/v1/sales-coach/team/sets` | read | `team:read` | List Team Sets |
+| [`searchCoachProspects`](#op-searchcoachprospects) | `GET /api/v1/sales-coach/prospects/search` | read | `team:read` | Search Coach Prospects |
+| [`sendInterviewInvite`](#op-sendinterviewinvite) | `POST /api/v1/sales-coach/interviews/{interview_id}/members/{member_id}/send-invite` | external | `team:run` | Send Interview Invite |
+| [`updateCall`](#op-updatecall) | `PUT /api/v1/sales-coach/calls/{call_id}` | write | `team:write` | Update Call |
+| [`updateTeamConfig`](#op-updateteamconfig) | `PUT /api/v1/sales-coach/team/config` | write | `team:write` | Update Team Config |
+| [`updateTeamLeaderboard`](#op-updateteamleaderboard) | `PUT /api/v1/sales-coach/team/leaderboards/{lb_id}` | write | `team:write` | Update Team Leaderboard |
+| [`updateTeamSet`](#op-updateteamset) | `PUT /api/v1/sales-coach/team/sets/{set_id}` | write | `team:write` | Update Team Set |
+
+---
+
+<a id="op-addinterviewmember"></a>
+
+### `g8.api.salesCoach.addInterviewMember(input)`
+
+**Add Interview Member**
+
+- HTTP: `POST /api/v1/sales-coach/interviews/{interview_id}/members`
+- operationId: `add_interview_member_sales_coach_interviews__interview_id__members_post` (also callable as `g8.api.call("add_interview_member_sales_coach_interviews__interview_id__members_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `team:run`
+
+Add someone to an interview round and mint their invite code.
+
+`send_invite=true` EMAILS THAT PERSON. It defaults to false, so adding a
+member is by default a quiet write and the mail is a separate decision -
+which is what makes it safe to build a whole round before anybody hears
+about it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.interview_id` | `string (uuid)` | yes | Interview round id (UUID). |
+| `body` | `AddInterviewMemberRequest` | yes | Request body; fields below. |
+
+Body fields (`AddInterviewMemberRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.email` | `string` | yes | min length 1 |
+| `body.name` | `string` | yes | min length 1 |
+| `body.send_invite` | `boolean` | no | Send the invite email now. TRUE REACHES A REAL PERSON. default `false` |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.salesCoach.addInterviewMember({
+  path: { interview_id: "00000000-0000-0000-0000-000000000000" },
+  body: { email: "jane@acme.com", name: "Example" },
+});
+```
+
+---
+
+<a id="op-assignteamrole"></a>
+
+### `g8.api.salesCoach.assignTeamRole(input)`
+
+**Assign Team Role**
+
+- HTTP: `PUT /api/v1/sales-coach/team/users/{user_id}/role`
+- operationId: `assign_team_role_sales_coach_team_users__user_id__role_put` (also callable as `g8.api.call("assign_team_role_sales_coach_team_users__user_id__role_put", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Grant a Team HQ role. THIS REPLACES THE PERSON'S PERMISSIONS.
+
+`cb_user_roles` has a composite primary key on (user_id, org_id), so the
+new row replaces whatever they had - this is a privilege grant, not a
+label on a dashboard.
+
+The app's three rules apply unchanged and each is a 403:
+
+  * the caller must be able to manage the team floor;
+  * no self-assignment, or a manager could re-role themselves;
+  * the caller must already hold every permission of the role they are
+    granting, unless they are an org Owner or Admin - Settings'
+    non-escalation rule.
+
+Only the five Team HQ slugs are assignable. `admin` is not one of them and
+is refused at the request layer.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.user_id` | `string` | yes | The member to re-role. |
+| `body` | `AssignTeamRoleRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignTeamRoleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.slug` | `"ae" \| "sdr" \| "csm" \| "campaign_manager" \| "sales_manager"` | yes | The role to grant. `admin` is not assignable here - it belongs to Settings -> Roles, behind the full RBAC admin gate. |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `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.salesCoach.assignTeamRole({ path: { user_id: "id" }, body: { slug: "ae" } });
+```
+
+---
+
+<a id="op-createcall"></a>
+
+### `g8.api.salesCoach.createCall(input)`
+
+**Create Call**
+
+- HTTP: `POST /api/v1/sales-coach/calls`
+- operationId: `create_call_sales_coach_calls_post` (also callable as `g8.api.call("create_call_sales_coach_calls_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Open a practice call record.
+
+This is the ROW, not the conversation: it is what a transcript, a score and
+an interview attempt all attach to. It does not start anything or reach
+anybody.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateCallRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateCallRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.call_mode` | `"compete" \| "assisted"` | yes | `compete` is the rep alone against the AI prospect; `assisted` is the coached variant. |
+| `body.persona_type` | `string \| null` | no |  |
+| `body.prospect_company` | `string \| null` | no |  |
+| `body.prospect_name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createCall({ body: { call_mode: "compete" } });
+```
+
+---
+
+<a id="op-createinterview"></a>
+
+### `g8.api.salesCoach.createInterview(input)`
+
+**Create Interview**
+
+- HTTP: `POST /api/v1/sales-coach/interviews`
+- operationId: `create_interview_sales_coach_interviews_post` (also callable as `g8.api.call("create_interview_sales_coach_interviews_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Create an interview round.
+
+Creating it invites nobody. Members are added separately, and only then can
+an invite go out.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateInterviewRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateInterviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.audience_id` | `string` | yes | Audience the prospect is drawn from. min length 1 |
+| `body.name` | `string` | yes | What the round is called. min length 1 |
+| `body.prospect_id` | `string` | yes | The contact the AI will play. min length 1 |
+| `body.behavior` | `string` | no | How the AI prospect behaves. Free-form: the app does not close this set. default `"Nay-sayer"`, min length 1 |
+| `body.code_ttl_days` | `integer \| null` | no | How long an invite code stays valid. Omit for the app default of 14 days. max 365, > 0 |
+| `body.max_attempts` | `integer` | no | How many times a member may try. default `3`, > 0 |
+| `body.prospect_name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createInterview({ body: { audience_id: "id", name: "Example", prospect_id: "id" } });
+```
+
+---
+
+<a id="op-createinterviewattempt"></a>
+
+### `g8.api.salesCoach.createInterviewAttempt(input)`
+
+**Create Interview Attempt**
+
+- HTTP: `POST /api/v1/sales-coach/interview-attempts`
+- operationId: `create_interview_attempt_sales_coach_interview_attempts_post` (also callable as `g8.api.call("create_interview_attempt_sales_coach_interview_attempts_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Attach an existing call to an interview round as an attempt.
+
+The call must already exist - this records that it COUNTED, it does not
+create it. Create the call first with `POST /sales-coach/calls`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateInterviewAttemptRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateInterviewAttemptRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.call_id` | `string (uuid)` | yes | The practice call this attempt is made of. |
+| `body.member_id` | `string (uuid) \| null` | no | Which member attempted it. Omit for an unattributed attempt. |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createInterviewAttempt({ body: { call_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-createinterviewattemptbycode"></a>
+
+### `g8.api.salesCoach.createInterviewAttemptByCode(input)`
+
+**Create Interview Attempt By Code**
+
+- HTTP: `POST /api/v1/sales-coach/interview-attempts/by-code/{code}`
+- operationId: `create_interview_attempt_by_code_sales_coach_interview_attempts_by_code__code__post` (also callable as `g8.api.call("create_interview_attempt_by_code_sales_coach_interview_attempts_by_code__code__post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Record an attempt identified by the member's CODE rather than their id.
+
+The path a candidate flow uses, where the code is the only thing on hand.
+An EXPIRED code is a 410, not a 404 - the distinction matters, because a
+410 means "this was real and the window closed" and is worth re-inviting
+for, while a 404 means the code never existed.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.code` | `string` | yes | The member's invite code. Matched case-insensitively. |
+| `body` | `CreateInterviewAttemptByCodeRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateInterviewAttemptByCodeRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.call_id` | `string (uuid)` | yes | The practice call this attempt is made of. |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createInterviewAttemptByCode({
+  path: { code: "example" },
+  body: { call_id: "00000000-0000-0000-0000-000000000000" },
+});
+```
+
+---
+
+<a id="op-createteamleaderboard"></a>
+
+### `g8.api.salesCoach.createTeamLeaderboard(input)`
+
+**Create Team Leaderboard**
+
+- HTTP: `POST /api/v1/sales-coach/team/leaderboards`
+- operationId: `create_team_leaderboard_sales_coach_team_leaderboards_post` (also callable as `g8.api.call("create_team_leaderboard_sales_coach_team_leaderboards_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Create a leaderboard.
+
+`id` is caller-chosen, matching the app: these are config rows keyed by a
+slug you pick, and POSTing an id that already exists UPSERTS rather than
+failing. Said plainly because a caller retrying a create would otherwise
+assume a duplicate was rejected.
+
+Requires team-floor management: org Owner/Admin, or an explicit
+`sales_manager` assignment.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `LeaderboardConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`LeaderboardConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.id` | `string` | yes | Caller-chosen id. Reusing one upserts, matching the app. |
+| `body.kpis` | `Array<LeaderboardKpi>` | yes |  |
+| `body.name` | `string` | yes |  |
+| `body.roles` | `Array<string>` | yes | Which team roles appear on this board. |
+| `body.goal` | `LeaderboardGoal \| null` | no |  |
+| `body.is_system` | `boolean` | no | Marks a board the product ships rather than one a customer made. Accepted because the app's model has it; leave it False for your own boards. default `false` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createTeamLeaderboard({
+  body: {
+    id: "id",
+    kpis: [{ id: "id", weight: 1 }],
+    name: "Example",
+    roles: ["example"],
+  },
+});
+```
+
+---
+
+<a id="op-createteamset"></a>
+
+### `g8.api.salesCoach.createTeamSet(input)`
+
+**Create Team Set**
+
+- HTTP: `POST /api/v1/sales-coach/team/sets`
+- operationId: `create_team_set_sales_coach_team_sets_post` (also callable as `g8.api.call("create_team_set_sales_coach_team_sets_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Create a rotation of leaderboards. Caller-chosen `id`, same as boards.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `SetConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`SetConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.id` | `string` | yes | Caller-chosen id. |
+| `body.leaderboard_ids` | `Array<string>` | yes | The boards to rotate through, in order. |
+| `body.name` | `string` | yes |  |
+| `body.audio_enabled` | `boolean` | no | Whether the display plays a sound on a change. default `false` |
+| `body.is_default` | `boolean` | no | default `false` |
+| `body.rotation_seconds` | `integer` | no | Seconds per board. The app's default is 30. default `30` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.createTeamSet({ body: { id: "id", leaderboard_ids: ["id"], name: "Example" } });
+```
+
+---
+
+<a id="op-deletecall"></a>
+
+### `g8.api.salesCoach.deleteCall(input)`
+
+**Delete Call**
+
+- HTTP: `DELETE /api/v1/sales-coach/calls/{call_id}`
+- operationId: `delete_call_sales_coach_calls__call_id__delete` (also callable as `g8.api.call("delete_call_sales_coach_calls__call_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Delete a practice call, with its transcript and scores.
+
+Owner-or-manager gated. Anything that ranked this call - a leaderboard, an
+interview attempt - loses it, so a score that was on the board disappears
+from it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.call_id` | `string (uuid)` | yes | Call id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `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.salesCoach.deleteCall({ path: { call_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-deleteinterview"></a>
+
+### `g8.api.salesCoach.deleteInterview(input)`
+
+**Delete Interview**
+
+- HTTP: `DELETE /api/v1/sales-coach/interviews/{interview_id}`
+- operationId: `delete_interview_sales_coach_interviews__interview_id__delete` (also callable as `g8.api.call("delete_interview_sales_coach_interviews__interview_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Delete an interview round.
+
+Its members' invite codes stop resolving, so anyone holding a link that has
+not been used yet loses it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.interview_id` | `string (uuid)` | yes | Interview round id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `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.salesCoach.deleteInterview({ path: { interview_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-deleteteamleaderboard"></a>
+
+### `g8.api.salesCoach.deleteTeamLeaderboard(input)`
+
+**Delete Team Leaderboard**
+
+- HTTP: `DELETE /api/v1/sales-coach/team/leaderboards/{lb_id}`
+- operationId: `delete_team_leaderboard_sales_coach_team_leaderboards__lb_id__delete` (also callable as `g8.api.call("delete_team_leaderboard_sales_coach_team_leaderboards__lb_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Delete a leaderboard.
+
+The app answers 204 with no body. This returns `{"deleted": true}` in the
+standard envelope instead, because every other operation on this contract
+returns one and a client that special-cased an empty body here would be
+the only place it had to.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.lb_id` | `string` | yes | Leaderboard id. |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `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.salesCoach.deleteTeamLeaderboard({ path: { lb_id: "id" } });
+```
+
+---
+
+<a id="op-deleteteamset"></a>
+
+### `g8.api.salesCoach.deleteTeamSet(input)`
+
+**Delete Team Set**
+
+- HTTP: `DELETE /api/v1/sales-coach/team/sets/{set_id}`
+- operationId: `delete_team_set_sales_coach_team_sets__set_id__delete` (also callable as `g8.api.call("delete_team_set_sales_coach_team_sets__set_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Delete a rotation. The leaderboards in it are untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.set_id` | `string` | yes | Set id. |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `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.salesCoach.deleteTeamSet({ path: { set_id: "id" } });
+```
+
+---
+
+<a id="op-getcall"></a>
+
+### `g8.api.salesCoach.getCall(input)`
+
+**Get Call**
+
+- HTTP: `GET /api/v1/sales-coach/calls/{call_id}`
+- operationId: `get_call_sales_coach_calls__call_id__get` (also callable as `g8.api.call("get_call_sales_coach_calls__call_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+One practice call. Owner-or-manager gated, same as the list.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.call_id` | `string (uuid)` | yes | Call id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getCall({ path: { call_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-getcallaudiourl"></a>
+
+### `g8.api.salesCoach.getCallAudioUrl(input)`
+
+**Get Call Audio Url**
+
+- HTTP: `GET /api/v1/sales-coach/calls/{call_id}/audio-url`
+- operationId: `get_call_audio_url_sales_coach_calls__call_id__audio_url_get` (also callable as `g8.api.call("get_call_audio_url_sales_coach_calls__call_id__audio_url_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+A time-limited link to the call recording.
+
+The URL is signed and expires: treat it as the credential it is, not as a
+permanent address to store. The gate runs BEFORE the link is minted, so a
+caller who may not read the call never receives one.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.call_id` | `string (uuid)` | yes | Call id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getCallAudioUrl({ path: { call_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-getcalltranscript"></a>
+
+### `g8.api.salesCoach.getCallTranscript(input)`
+
+**Get Call Transcript**
+
+- HTTP: `GET /api/v1/sales-coach/calls/{call_id}/transcript`
+- operationId: `get_call_transcript_sales_coach_calls__call_id__transcript_get` (also callable as `g8.api.call("get_call_transcript_sales_coach_calls__call_id__transcript_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+What was actually said, segment by segment.
+
+Owner-or-manager gated for the same reason the call is: this is the most
+revealing artifact the feature holds.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.call_id` | `string (uuid)` | yes | Call id (UUID). |
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getCallTranscript({ path: { call_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-getinterview"></a>
+
+### `g8.api.salesCoach.getInterview(input)`
+
+**Get Interview**
+
+- HTTP: `GET /api/v1/sales-coach/interviews/{interview_id}`
+- operationId: `get_interview_sales_coach_interviews__interview_id__get` (also callable as `g8.api.call("get_interview_sales_coach_interviews__interview_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+One interview round, with its members.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.interview_id` | `string (uuid)` | yes | Interview round id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getInterview({ path: { interview_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-getinterviewbycode"></a>
+
+### `g8.api.salesCoach.getInterviewByCode(input)`
+
+**Get Interview By Code**
+
+- HTTP: `GET /api/v1/sales-coach/interviews/by-code/{code}`
+- operationId: `get_interview_by_code_sales_coach_interviews_by_code__code__get` (also callable as `g8.api.call("get_interview_by_code_sales_coach_interviews_by_code__code__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Resolve an invite code to the round it belongs to.
+
+Published as `by-code` rather than the app's `code` so it reads the same
+way as `/interview-attempts/by-code/{code}` - the app spells the same idea
+two ways and a public contract should not inherit that.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.code` | `string` | yes | A member's invite code. |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getInterviewByCode({ path: { code: "example" } });
+```
+
+---
+
+<a id="op-getsalescoachleaderboard"></a>
+
+### `g8.api.salesCoach.getSalesCoachLeaderboard(input?)`
+
+**Get Sales Coach Leaderboard**
+
+- HTTP: `GET /api/v1/sales-coach/leaderboard`
+- operationId: `get_sales_coach_leaderboard_sales_coach_leaderboard_get` (also callable as `g8.api.call("get_sales_coach_leaderboard_sales_coach_leaderboard_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The coaching leaderboard: every rep, ranked.
+
+This is the module's own board, distinct from the CONFIGURABLE boards
+under `/team/leaderboards` - it takes no configuration and no period.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamListPayload_`: the envelope `{ data: TeamListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`TeamListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getSalesCoachLeaderboard();
+```
+
+---
+
+<a id="op-getteamactiveuserssummary"></a>
+
+### `g8.api.salesCoach.getTeamActiveUsersSummary(input?)`
+
+**Get Team Active Users Summary**
+
+- HTTP: `GET /api/v1/sales-coach/team/active-users-summary`
+- operationId: `get_team_active_users_summary_sales_coach_team_active_users_summary_get` (also callable as `g8.api.call("get_team_active_users_summary_sales_coach_team_active_users_summary_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Who is active, and who can be put on a board.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamActiveUsersSummary();
+```
+
+---
+
+<a id="op-getteambootstrap"></a>
+
+### `g8.api.salesCoach.getTeamBootstrap(input?)`
+
+**Get Team Bootstrap**
+
+- HTTP: `GET /api/v1/sales-coach/team/bootstrap`
+- operationId: `get_team_bootstrap_sales_coach_team_bootstrap_get` (also callable as `g8.api.call("get_team_bootstrap_sales_coach_team_bootstrap_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Everything a Team HQ screen needs in ONE call.
+
+The boards, the sets, the config and the first page of data together.
+Built for a display that would otherwise make five round trips before it
+can render anything, and it is the right call for a dashboard rebuilding
+this rather than fetching each piece.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.period` | `string` | no | Window to score over. `today` is the app's default; the values a given org accepts come back in `visible_periods` from `GET /sales-coach/team/config`, because the set is configurable. default `"today"` |
+| `query.lb` | `string \| null` | no | Leaderboard to open on. |
+| `query.set` | `string \| null` | no | Rotation to open on. The wire name is `set`, matching the app's `?set=` query parameter; `set` is a Python builtin, so the handler parameter is `set_id` and the alias keeps the wire name identical to the app's. |
+| `query.role` | `string \| null` | no | Legacy fallback when neither `lb` nor `set` is given. |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamBootstrap();
+```
+
+---
+
+<a id="op-getteamconfig"></a>
+
+### `g8.api.salesCoach.getTeamConfig(input?)`
+
+**Get Team Config**
+
+- HTTP: `GET /api/v1/sales-coach/team/config`
+- operationId: `get_team_config_sales_coach_team_config_get` (also callable as `g8.api.call("get_team_config_sales_coach_team_config_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Team Command Center settings: visible columns, periods, goals, rotation.
+
+Read this before scoring anything: `visible_periods` is the set of values
+the `period` query parameter accepts for THIS org.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamConfig();
+```
+
+---
+
+<a id="op-getteamkpicatalog"></a>
+
+### `g8.api.salesCoach.getTeamKpiCatalog(input?)`
+
+**Get Team Kpi Catalog**
+
+- HTTP: `GET /api/v1/sales-coach/team/kpi-catalog`
+- operationId: `get_team_kpi_catalog_sales_coach_team_kpi_catalog_get` (also callable as `g8.api.call("get_team_kpi_catalog_sales_coach_team_kpi_catalog_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Every KPI a leaderboard can be built from, with its default weight.
+
+The source of the `id` values a leaderboard's `kpis` refer to - build a
+board from anything else and it scores nothing.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamListPayload_`: the envelope `{ data: TeamListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`TeamListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamKpiCatalog();
+```
+
+---
+
+<a id="op-getteamleaderboarddata"></a>
+
+### `g8.api.salesCoach.getTeamLeaderboardData(input)`
+
+**Get Team Leaderboard Data**
+
+- HTTP: `GET /api/v1/sales-coach/team/leaderboards/{lb_id}/data`
+- operationId: `get_team_leaderboard_data_sales_coach_team_leaderboards__lb_id__data_get` (also callable as `g8.api.call("get_team_leaderboard_data_sales_coach_team_leaderboards__lb_id__data_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The scores: one row per rep, one column per KPI on the board.
+
+Open-shaped, because the columns are whichever KPIs the board is
+configured with - including a customer's own. A closed model would drop
+one, and a missing column reads as a rep having scored nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.lb_id` | `string` | yes | Leaderboard id. |
+| `query.period` | `string` | no | Window to score over. `today` is the app's default; the values a given org accepts come back in `visible_periods` from `GET /sales-coach/team/config`, because the set is configurable. default `"today"` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamLeaderboardData({ path: { lb_id: "id" } });
+```
+
+---
+
+<a id="op-getteamsetdata"></a>
+
+### `g8.api.salesCoach.getTeamSetData(input)`
+
+**Get Team Set Data**
+
+- HTTP: `GET /api/v1/sales-coach/team/sets/{set_id}/data`
+- operationId: `get_team_set_data_sales_coach_team_sets__set_id__data_get` (also callable as `g8.api.call("get_team_set_data_sales_coach_team_sets__set_id__data_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Every board in the rotation, scored, in one call.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.set_id` | `string` | yes | Set id. |
+| `query.period` | `string` | no | Window to score over. `today` is the app's default; the values a given org accepts come back in `visible_periods` from `GET /sales-coach/team/config`, because the set is configurable. default `"today"` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.getTeamSetData({ path: { set_id: "id" } });
+```
+
+---
+
+<a id="op-listcalls"></a>
+
+### `g8.api.salesCoach.listCalls(input?)`
+
+**List Calls**
+
+- HTTP: `GET /api/v1/sales-coach/calls`
+- operationId: `list_calls_sales_coach_calls_get` (also callable as `g8.api.call("list_calls_sales_coach_calls_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Practice calls, newest first, with their scores and transcript segments.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.email` | `string \| null` | no | Whose calls to read. Omit for the key owner's own. Naming SOMEBODY ELSE is manager-only and comes back 403 otherwise - calls carry transcripts and scores. |
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listCalls();
+```
+
+---
+
+<a id="op-listcoachcontactlists"></a>
+
+### `g8.api.salesCoach.listCoachContactLists(input?)`
+
+**List Coach Contact Lists**
+
+- HTTP: `GET /api/v1/sales-coach/contact-lists`
+- operationId: `list_coach_contact_lists_sales_coach_contact_lists_get` (also callable as `g8.api.call("list_coach_contact_lists_sales_coach_contact_lists_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Audiences a practice call or interview round can draw a prospect from.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.only_tagged` | `boolean` | no | Only lists tagged for coaching, rather than every audience. default `false` |
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listCoachContactLists();
+```
+
+---
+
+<a id="op-listinterviewattempts"></a>
+
+### `g8.api.salesCoach.listInterviewAttempts(input?)`
+
+**List Interview Attempts**
+
+- HTTP: `GET /api/v1/sales-coach/interview-attempts`
+- operationId: `list_interview_attempts_sales_coach_interview_attempts_get` (also callable as `g8.api.call("list_interview_attempts_sales_coach_interview_attempts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Who sat an interview round, and against which call.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.call_id` | `string (uuid) \| null` | no | Only attempts made of this call. |
+| `query.member_id` | `string (uuid) \| null` | no | Only this member's attempts. |
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listInterviewAttempts();
+```
+
+---
+
+<a id="op-listinterviews"></a>
+
+### `g8.api.salesCoach.listInterviews(input?)`
+
+**List Interviews**
+
+- HTTP: `GET /api/v1/sales-coach/interviews`
+- operationId: `list_interviews_sales_coach_interviews_get` (also callable as `g8.api.call("list_interviews_sales_coach_interviews_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Every interview round in the organisation.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listInterviews();
+```
+
+---
+
+<a id="op-listteamleaderboards"></a>
+
+### `g8.api.salesCoach.listTeamLeaderboards(input?)`
+
+**List Team Leaderboards**
+
+- HTTP: `GET /api/v1/sales-coach/team/leaderboards`
+- operationId: `list_team_leaderboards_sales_coach_team_leaderboards_get` (also callable as `g8.api.call("list_team_leaderboards_sales_coach_team_leaderboards_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Every configured leaderboard, including the ones the product ships.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamListPayload_`: the envelope `{ data: TeamListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`TeamListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listTeamLeaderboards();
+```
+
+---
+
+<a id="op-listteamroles"></a>
+
+### `g8.api.salesCoach.listTeamRoles(input?)`
+
+**List Team Roles**
+
+- HTTP: `GET /api/v1/sales-coach/team/roles`
+- operationId: `list_team_roles_sales_coach_team_roles_get` (also callable as `g8.api.call("list_team_roles_sales_coach_team_roles_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The Team HQ roles, and who holds them.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamListPayload_`: the envelope `{ data: TeamListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`TeamListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listTeamRoles();
+```
+
+---
+
+<a id="op-listteamsets"></a>
+
+### `g8.api.salesCoach.listTeamSets(input?)`
+
+**List Team Sets**
+
+- HTTP: `GET /api/v1/sales-coach/team/sets`
+- operationId: `list_team_sets_sales_coach_team_sets_get` (also callable as `g8.api.call("list_team_sets_sales_coach_team_sets_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Configured rotations.
+
+**Input**: none.
+
+**Returns** `ApiResponse_TeamListPayload_`: the envelope `{ data: TeamListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`TeamListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.listTeamSets();
+```
+
+---
+
+<a id="op-searchcoachprospects"></a>
+
+### `g8.api.salesCoach.searchCoachProspects(input)`
+
+**Search Coach Prospects**
+
+- HTTP: `GET /api/v1/sales-coach/prospects/search`
+- operationId: `search_coach_prospects_sales_coach_prospects_search_get` (also callable as `g8.api.call("search_coach_prospects_sales_coach_prospects_search_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Find the prospect the AI will play.
+
+Paginated, because an audience is routinely larger than a picker: `offset`
+plus `limit` rather than a page number, matching the app.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.audience_id` | `string` | yes | Audience to search within. |
+| `query.q` | `string` | no | Free text over the prospect's name and company. default `""` |
+| `query.limit` | `integer` | no | default `50` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_CoachListPayload_`: the envelope `{ data: CoachListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CoachListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.searchCoachProspects({ query: { audience_id: "id" } });
+```
+
+---
+
+<a id="op-sendinterviewinvite"></a>
+
+### `g8.api.salesCoach.sendInterviewInvite(input)`
+
+**Send Interview Invite**
+
+- HTTP: `POST /api/v1/sales-coach/interviews/{interview_id}/members/{member_id}/send-invite`
+- operationId: `send_interview_invite_sales_coach_interviews__interview_id__members__member_id__send_invite_post` (also callable as `g8.api.call("send_interview_invite_sales_coach_interviews__interview_id__members__member_id__send_invite_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `team:run`
+
+Send - or re-send - a member's invite email. THIS REACHES A REAL PERSON.
+
+Tiered `external` rather than `write` for that reason: a customer can hand
+out "build interview rounds" without handing out "email my candidates".
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.interview_id` | `string (uuid)` | yes | Interview round id (UUID). |
+| `path.member_id` | `string (uuid)` | yes | Member id (UUID). |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.salesCoach.sendInterviewInvite({
+  path: {
+    interview_id: "00000000-0000-0000-0000-000000000000",
+    member_id: "00000000-0000-0000-0000-000000000000",
+  },
+});
+```
+
+---
+
+<a id="op-updatecall"></a>
+
+### `g8.api.salesCoach.updateCall(input)`
+
+**Update Call**
+
+- HTTP: `PUT /api/v1/sales-coach/calls/{call_id}`
+- operationId: `update_call_sales_coach_calls__call_id__put` (also callable as `g8.api.call("update_call_sales_coach_calls__call_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Amend a call record.
+
+`final_score` is the number a leaderboard reads, so writing it here changes
+what the team ranking shows. Only the fields you send are written.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.call_id` | `string (uuid)` | yes | Call id (UUID). |
+| `body` | `UpdateCallRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateCallRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.audio_url` | `string \| null` | no | Where the recording lives. |
+| `body.call_status` | `string \| null` | no | New status for the call. |
+| `body.duration_ms` | `integer \| null` | no | Call length in milliseconds. |
+| `body.final_score` | `integer \| null` | no | Score for the call. |
+
+**Returns** `ApiResponse_CoachPayload_`: the envelope `{ data: CoachPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.updateCall({
+  path: { call_id: "00000000-0000-0000-0000-000000000000" },
+  body: {},
+});
+```
+
+---
+
+<a id="op-updateteamconfig"></a>
+
+### `g8.api.salesCoach.updateTeamConfig(input)`
+
+**Update Team Config**
+
+- HTTP: `PUT /api/v1/sales-coach/team/config`
+- operationId: `update_team_config_sales_coach_team_config_put` (also callable as `g8.api.call("update_team_config_sales_coach_team_config_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Change Team Command Center settings. Team-floor management required.
+
+The body is OPEN, mirroring the app's own model: this config is a JSONB bag
+that grows, and its DTO carries `extra="allow"` with a comment calling that
+an intentional deviation. Closing it here would reject a key the app
+itself stores.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `TeamConfigUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamConfigUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.default_period` | `string \| null` | no |  |
+| `body.goals` | `Record<string, Record<string, unknown>> \| null` | no |  |
+| `body.team_command_center_enabled` | `boolean \| null` | no |  |
+| `body.tv_rotation_seconds` | `integer \| null` | no |  |
+| `body.visible_columns` | `Record<string, Array<string>> \| null` | no |  |
+| `body.visible_periods` | `Array<string> \| null` | no |  |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.updateTeamConfig({ body: {} });
+```
+
+---
+
+<a id="op-updateteamleaderboard"></a>
+
+### `g8.api.salesCoach.updateTeamLeaderboard(input)`
+
+**Update Team Leaderboard**
+
+- HTTP: `PUT /api/v1/sales-coach/team/leaderboards/{lb_id}`
+- operationId: `update_team_leaderboard_sales_coach_team_leaderboards__lb_id__put` (also callable as `g8.api.call("update_team_leaderboard_sales_coach_team_leaderboards__lb_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Replace a leaderboard's configuration.
+
+A PUT, matching the app: the body is the board's new state, so a KPI you
+omit is REMOVED from the board rather than left alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.lb_id` | `string` | yes | Leaderboard id. |
+| `body` | `LeaderboardConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`LeaderboardConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.id` | `string` | yes | Caller-chosen id. Reusing one upserts, matching the app. |
+| `body.kpis` | `Array<LeaderboardKpi>` | yes |  |
+| `body.name` | `string` | yes |  |
+| `body.roles` | `Array<string>` | yes | Which team roles appear on this board. |
+| `body.goal` | `LeaderboardGoal \| null` | no |  |
+| `body.is_system` | `boolean` | no | Marks a board the product ships rather than one a customer made. Accepted because the app's model has it; leave it False for your own boards. default `false` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.updateTeamLeaderboard({
+  path: { lb_id: "id" },
+  body: {
+    id: "id",
+    kpis: [{ id: "id", weight: 1 }],
+    name: "Example",
+    roles: ["example"],
+  },
+});
+```
+
+---
+
+<a id="op-updateteamset"></a>
+
+### `g8.api.salesCoach.updateTeamSet(input)`
+
+**Update Team Set**
+
+- HTTP: `PUT /api/v1/sales-coach/team/sets/{set_id}`
+- operationId: `update_team_set_sales_coach_team_sets__set_id__put` (also callable as `g8.api.call("update_team_set_sales_coach_team_sets__set_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Replace a rotation. A PUT: an omitted board leaves the rotation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.set_id` | `string` | yes | Set id. |
+| `body` | `SetConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`SetConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.id` | `string` | yes | Caller-chosen id. |
+| `body.leaderboard_ids` | `Array<string>` | yes | The boards to rotate through, in order. |
+| `body.name` | `string` | yes |  |
+| `body.audio_enabled` | `boolean` | no | Whether the display plays a sound on a change. default `false` |
+| `body.is_default` | `boolean` | no | default `false` |
+| `body.rotation_seconds` | `integer` | no | Seconds per board. The app's default is 30. default `30` |
+
+**Returns** `ApiResponse_TeamPayload_`: the envelope `{ data: TeamPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.salesCoach.updateTeamSet({
+  path: { set_id: "id" },
+  body: { id: "id", leaderboard_ids: ["id"], name: "Example" },
+});
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-leaderboardgoal"></a>
+
+### `LeaderboardGoal`
+
+The target a leaderboard is measured against.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `metric` | `string` | yes |  |
+| `period` | `string` | yes |  |
+| `target` | `number` | yes |  |
+
+<a id="type-leaderboardkpi"></a>
+
+### `LeaderboardKpi`
+
+One metric on a leaderboard, with its weight and visibility.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes | KPI id from `GET /sales-coach/team/kpi-catalog`. |
+| `weight` | `number` | yes | How much this KPI counts toward the ranking. |
+| `visible` | `boolean` | no | default `true` |