@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/copilot.md

@@ -0,0 +1,1765 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.copilot`: Copilot
+
+39 operations (17 read, 18 write, 1 destructive, 3 billable).
+
+No hand-written client covers this area. Call it through `g8.api.copilot.*` 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: [copilot.d.ts](copilot.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`appendCopilotMemoryDocument`](#op-appendcopilotmemorydocument) | `POST /api/v1/copilot/memory/documents/append` | write | `knowledge:write` | Append Copilot Memory Document |
+| [`browseCopilotPersonalWikiDrive`](#op-browsecopilotpersonalwikidrive) | `GET /api/v1/copilot/personal-wiki/drive` | read | `knowledge:read` | Browse Copilot Personal Wiki Drive |
+| [`captureCopilotSoul`](#op-capturecopilotsoul) | `POST /api/v1/copilot/memory/soul-capture` | write | `knowledge:write` | Capture Copilot Soul |
+| [`chatWithCopilot`](#op-chatwithcopilot) | `POST /api/v1/copilot/chat` | billable | `knowledge:run` | Chat With Copilot |
+| [`chooseCopilotContactMatch`](#op-choosecopilotcontactmatch) | `POST /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches` | write | `knowledge:write` | Choose Copilot Contact Match |
+| [`confirmCopilotPersonalWikiFact`](#op-confirmcopilotpersonalwikifact) | `POST /api/v1/copilot/personal-wiki/confirm` | write | `knowledge:write` | Confirm Copilot Personal Wiki Fact |
+| [`correctCopilotContactIdentity`](#op-correctcopilotcontactidentity) | `POST /api/v1/copilot/personal-wiki/relationships/identity` | write | `knowledge:write` | Correct Copilot Contact Identity |
+| [`correctCopilotPersonalWikiFact`](#op-correctcopilotpersonalwikifact) | `POST /api/v1/copilot/personal-wiki/correct` | write | `knowledge:write` | Correct Copilot Personal Wiki Fact |
+| [`createCopilotMemory`](#op-createcopilotmemory) | `POST /api/v1/copilot/memory` | write | `knowledge:write` | Create Copilot Memory |
+| [`deleteCopilotMemory`](#op-deletecopilotmemory) | `DELETE /api/v1/copilot/memory/{memory_id}` | destructive | `knowledge:delete` | Delete Copilot Memory |
+| [`editCopilotPersonalWikiItem`](#op-editcopilotpersonalwikiitem) | `PUT /api/v1/copilot/personal-wiki/items/{item_id}` | write | `knowledge:write` | Edit Copilot Personal Wiki Item |
+| [`forgetCopilotPersonalWikiFact`](#op-forgetcopilotpersonalwikifact) | `POST /api/v1/copilot/personal-wiki/forget` | write | `knowledge:write` | Forget Copilot Personal Wiki Fact |
+| [`getCopilotContactSharing`](#op-getcopilotcontactsharing) | `GET /api/v1/copilot/personal-wiki/contact-sharing` | read | `knowledge:read` | Get Copilot Contact Sharing |
+| [`getCopilotLinkedinConnections`](#op-getcopilotlinkedinconnections) | `GET /api/v1/copilot/personal-wiki/linkedin-connections` | read | `knowledge:read` | Get Copilot Linkedin Connections |
+| [`getCopilotMemoryContext`](#op-getcopilotmemorycontext) | `GET /api/v1/copilot/memory/context` | read | `knowledge:read` | Get Copilot Memory Context |
+| [`getCopilotMemoryDocuments`](#op-getcopilotmemorydocuments) | `GET /api/v1/copilot/memory/documents` | read | `knowledge:read` | Get Copilot Memory Documents |
+| [`getCopilotPersonalWiki`](#op-getcopilotpersonalwiki) | `GET /api/v1/copilot/personal-wiki` | read | `knowledge:read` | Get Copilot Personal Wiki |
+| [`getCopilotPersonalWikiDocument`](#op-getcopilotpersonalwikidocument) | `GET /api/v1/copilot/personal-wiki/documents/{section}` | read | `knowledge:read` | Get Copilot Personal Wiki Document |
+| [`getCopilotPersonalWikiRelationship`](#op-getcopilotpersonalwikirelationship) | `GET /api/v1/copilot/personal-wiki/relationships/{contact_id}` | read | `knowledge:read` | Get Copilot Personal Wiki Relationship |
+| [`getCopilotPersonalWikiSources`](#op-getcopilotpersonalwikisources) | `GET /api/v1/copilot/personal-wiki/sources` | read | `knowledge:read` | Get Copilot Personal Wiki Sources |
+| [`listCopilotContactContributions`](#op-listcopilotcontactcontributions) | `GET /api/v1/copilot/personal-wiki/contact-sharing/contributions` | read | `knowledge:read` | List Copilot Contact Contributions |
+| [`listCopilotContactMatches`](#op-listcopilotcontactmatches) | `GET /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches` | read | `knowledge:read` | List Copilot Contact Matches |
+| [`listCopilotMemories`](#op-listcopilotmemories) | `GET /api/v1/copilot/memory` | read | `knowledge:read` | List Copilot Memories |
+| [`listCopilotPersonalWikiRelationships`](#op-listcopilotpersonalwikirelationships) | `GET /api/v1/copilot/personal-wiki/relationships` | read | `knowledge:read` | List Copilot Personal Wiki Relationships |
+| [`listCopilotTools`](#op-listcopilottools) | `GET /api/v1/copilot/tools` | read | `knowledge:read` | List Copilot Tools |
+| [`previewCopilotPersonalWikiDriveSelection`](#op-previewcopilotpersonalwikidriveselection) | `POST /api/v1/copilot/personal-wiki/drive-selection/preview` | read | `knowledge:read` | Preview Copilot Personal Wiki Drive Selection |
+| [`promoteCopilotMemory`](#op-promotecopilotmemory) | `POST /api/v1/copilot/memory/promote` | billable | `knowledge:run` | Promote Copilot Memory |
+| [`resolveCopilotContactContribution`](#op-resolvecopilotcontactcontribution) | `POST /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/resolve` | write | `knowledge:write` | Resolve Copilot Contact Contribution |
+| [`runCopilotLandingPageAction`](#op-runcopilotlandingpageaction) | `POST /api/v1/copilot/landing-page-action` | billable | `knowledge:run` | Run Copilot Landing Page Action |
+| [`saveCopilotPersonalWikiDriveSelection`](#op-savecopilotpersonalwikidriveselection) | `PUT /api/v1/copilot/personal-wiki/drive-selection` | write | `knowledge:write` | Save Copilot Personal Wiki Drive Selection |
+| [`searchCopilotContactIdentities`](#op-searchcopilotcontactidentities) | `GET /api/v1/copilot/personal-wiki/contact-identities` | read | `knowledge:read` | Search Copilot Contact Identities |
+| [`searchCopilotMentions`](#op-searchcopilotmentions) | `POST /api/v1/copilot/mention-search` | read | `knowledge:read` | Search Copilot Mentions |
+| [`updateCopilotContactContribution`](#op-updatecopilotcontactcontribution) | `PUT /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}` | write | `knowledge:write` | Update Copilot Contact Contribution |
+| [`updateCopilotContactPeopleChoice`](#op-updatecopilotcontactpeoplechoice) | `PUT /api/v1/copilot/personal-wiki/contact-sharing/people/choice` | write | `knowledge:write` | Update Copilot Contact People Choice |
+| [`updateCopilotContactSharing`](#op-updatecopilotcontactsharing) | `PUT /api/v1/copilot/personal-wiki/contact-sharing/{mailbox_id}` | write | `knowledge:write` | Update Copilot Contact Sharing |
+| [`updateCopilotLinkedinConnections`](#op-updatecopilotlinkedinconnections) | `PUT /api/v1/copilot/personal-wiki/linkedin-connections` | write | `knowledge:write` | Update Copilot Linkedin Connections |
+| [`updateCopilotPersonalWiki`](#op-updatecopilotpersonalwiki) | `PUT /api/v1/copilot/personal-wiki` | write | `knowledge:write` | Update Copilot Personal Wiki |
+| [`updateCopilotPersonalWikiSources`](#op-updatecopilotpersonalwikisources) | `PUT /api/v1/copilot/personal-wiki/sources` | write | `knowledge:write` | Update Copilot Personal Wiki Sources |
+| [`upsertCopilotMemoryDocument`](#op-upsertcopilotmemorydocument) | `PUT /api/v1/copilot/memory/documents` | write | `knowledge:write` | Upsert Copilot Memory Document |
+
+---
+
+<a id="op-appendcopilotmemorydocument"></a>
+
+### `g8.api.copilot.appendCopilotMemoryDocument(input)`
+
+**Append Copilot Memory Document**
+
+- HTTP: `POST /api/v1/copilot/memory/documents/append`
+- operationId: `append_copilot_memory_document_copilot_memory_documents_append_post` (also callable as `g8.api.call("append_copilot_memory_document_copilot_memory_documents_append_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Add to a memory document without replacing it.
+
+Defaults to the `daily` journal, which is where observations belong: the
+durable documents are meant to be curated from it by
+`POST /copilot/memory/promote`, not written to directly on every event.
+
+Takes a JSON BODY. The app takes these as query parameters, which would put
+the text of a personal note into the URL.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `MemoryDocumentAppendRequest` | yes | Request body; fields below. |
+
+Body fields (`MemoryDocumentAppendRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content` | `string` | yes | The text to append. min length 1 |
+| `body.subject_id` | `string` | yes | Which one. |
+| `body.subject_type` | `string` | yes | What the document is about: organization, user, campaign, company or contact. |
+| `body.file_kind` | `string` | no | Which document to append to. `daily` is the rolling journal and is the default; `memory` and `soul` are the durable ones and are normally written through `PUT /copilot/memory/documents` instead. default `"daily"` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.appendCopilotMemoryDocument({
+  body: { content: "example", subject_id: "id", subject_type: "Example" },
+});
+```
+
+---
+
+<a id="op-browsecopilotpersonalwikidrive"></a>
+
+### `g8.api.copilot.browseCopilotPersonalWikiDrive(input)`
+
+**Browse Copilot Personal Wiki Drive**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/drive`
+- operationId: `browse_copilot_personal_wiki_drive_copilot_personal_wiki_drive_get` (also callable as `g8.api.call("browse_copilot_personal_wiki_drive_copilot_personal_wiki_drive_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Browse the Google Drive of one of your connected mailboxes, to pick what
+the Copilot may read.
+
+Reads Drive through the mailbox's own grant. A 403 means the grant does
+not include Drive; a 409 means the Google account behind the mailbox has
+changed since it was connected.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.mailbox_id` | `integer` | yes | Integer `mailboxes.id` of the connected Google account. |
+| `query.parent_id` | `string` | no | Folder to list. `root` is the top of My Drive. default `"root"` |
+| `query.page_token` | `string \| null` | no | From the previous page. |
+| `query.search` | `string` | no | Search by name instead of listing a folder. default `""` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.browseCopilotPersonalWikiDrive({ query: { mailbox_id: 1 } });
+```
+
+---
+
+<a id="op-capturecopilotsoul"></a>
+
+### `g8.api.copilot.captureCopilotSoul(input)`
+
+**Capture Copilot Soul**
+
+- HTTP: `POST /api/v1/copilot/memory/soul-capture`
+- operationId: `capture_copilot_soul_copilot_memory_soul_capture_post` (also callable as `g8.api.call("capture_copilot_soul_copilot_memory_soul_capture_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Set the organisation's and the user's foundational documents in one call.
+
+The onboarding shortcut: it is how a new workspace tells the assistant who
+it works for before there is any history to learn from. Every field is
+optional and sending one does not clear the others.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `SoulCaptureRequest` | yes | Request body; fields below. |
+
+Body fields (`SoulCaptureRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.org_memory` | `string \| null` | no | Durable org-level facts. |
+| `body.org_soul` | `string \| null` | no | Who the organisation is. |
+| `body.user_memory` | `string \| null` | no | Durable facts about this person. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.captureCopilotSoul({ body: {} });
+```
+
+---
+
+<a id="op-chatwithcopilot"></a>
+
+### `g8.api.copilot.chatWithCopilot(input)`
+
+**Chat With Copilot**
+
+- HTTP: `POST /api/v1/copilot/chat`
+- operationId: `chat_with_copilot_copilot_chat_post` (also callable as `g8.api.call("chat_with_copilot_copilot_chat_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `knowledge:run`
+
+Ask the Studio copilot. SPENDS CREDIT - a model runs, and may call tools.
+
+Returns `response` (the full answer) and `events` (every text, tool and
+source event, in order). `web_search`, `thinking` and `research` each add
+work and cost; `research` the most. Tools that need a person's approval
+are proposed in `events`, not executed. 402 when the org is out of credit.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CopilotChatRequest` | yes | Request body; fields below. |
+
+Body fields (`CopilotChatRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.message` | `string` | yes | min length 1 |
+| `body.canvas_context` | `CopilotCanvasContext \| null` | no |  |
+| `body.conversation_history` | `Array<CopilotChatMessage> \| null` | no |  |
+| `body.mentions` | `Array<Record<string, unknown>> \| null` | no | Results from `POST /copilot/mention-search`. |
+| `body.research` | `boolean` | no | Multi-step deep research. The most expensive option. default `false` |
+| `body.session_id` | `string \| null` | no |  |
+| `body.thinking` | `boolean` | no | Extended thinking. default `false` |
+| `body.web_search` | `boolean` | no | Search the web before answering. default `false` |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `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.copilot.chatWithCopilot({ body: { message: "example" } });
+```
+
+---
+
+<a id="op-choosecopilotcontactmatch"></a>
+
+### `g8.api.copilot.chooseCopilotContactMatch(input)`
+
+**Choose Copilot Contact Match**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches`
+- operationId: `choose_copilot_contact_match_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_post` (also callable as `g8.api.call("choose_copilot_contact_match_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Say WHICH person a contribution is about.
+
+Binds it to one CRM contact, so the subsequent per-field decisions land on
+the right record. Guarded by both revision tokens for the same reason the
+resolve is.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contribution_id` | `string` | yes | Contribution id (UUID). |
+| `body` | `PersonalContactMatchRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactMatchRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.contact_id` | `integer` | yes | The CRM contact this contribution is actually about. max 9223372036854776000, > 0 |
+| `body.expected_canonical_revision` | `string` | yes | min length 64, max length 64 |
+| `body.expected_revision` | `integer` | yes | min 1 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.chooseCopilotContactMatch({
+  path: { contribution_id: "id" },
+  body: {
+    contact_id: 1,
+    expected_canonical_revision: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    expected_revision: 1,
+  },
+});
+```
+
+---
+
+<a id="op-confirmcopilotpersonalwikifact"></a>
+
+### `g8.api.copilot.confirmCopilotPersonalWikiFact(input)`
+
+**Confirm Copilot Personal Wiki Fact**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/confirm`
+- operationId: `confirm_copilot_personal_wiki_fact_copilot_personal_wiki_confirm_post` (also callable as `g8.api.call("confirm_copilot_personal_wiki_fact_copilot_personal_wiki_confirm_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Tell the assistant an inferred fact is RIGHT.
+
+Worth doing rather than ignoring: a confirmed fact stops being re-derived
+and re-questioned, and it outranks a later contradicting inference.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalWikiFactActionRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiFactActionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.fact_id` | `string` | yes | The fact. min length 1, max length 255 |
+| `body.reason` | `string \| null` | no | Why. Optional, and worth sending on a forget: it is the only record of why something was removed from what the Copilot knows. max length 2000 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.confirmCopilotPersonalWikiFact({ body: { fact_id: "id" } });
+```
+
+---
+
+<a id="op-correctcopilotcontactidentity"></a>
+
+### `g8.api.copilot.correctCopilotContactIdentity(input)`
+
+**Correct Copilot Contact Identity**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/relationships/identity`
+- operationId: `correct_copilot_contact_identity_copilot_personal_wiki_relationships_identity_post` (also callable as `g8.api.call("correct_copilot_contact_identity_copilot_personal_wiki_relationships_identity_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Re-attribute facts to the right person - or to nobody.
+
+Sending a null `contact_id` DETACHES the facts rather than being ignored:
+it is how you say "this is not about anyone in the CRM". Up to a thousand
+facts move at once, because a misattribution is usually systematic rather
+than a single fact.
+
+Declared BEFORE `/personal-wiki/relationships/{contact_id}` so the literal
+`identity` segment cannot be captured as a contact id.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalContactIdentityRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactIdentityRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.expected_version` | `integer` | yes | Optimistic-concurrency token for the relationship record. min 0 |
+| `body.fact_ids` | `Array<string>` | yes | The facts being re-attributed, all to the same person. min items 1, max items 1000 |
+| `body.contact_id` | `integer \| null` | no | Who they are really about. NULL DETACHES them from whoever they are attributed to now, rather than being ignored - it is how you say 'this is not about anyone in the CRM'. max 9223372036854776000, > 0 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.correctCopilotContactIdentity({ body: { expected_version: 0, fact_ids: ["id"] } });
+```
+
+---
+
+<a id="op-correctcopilotpersonalwikifact"></a>
+
+### `g8.api.copilot.correctCopilotPersonalWikiFact(input)`
+
+**Correct Copilot Personal Wiki Fact**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/correct`
+- operationId: `correct_copilot_personal_wiki_fact_copilot_personal_wiki_correct_post` (also callable as `g8.api.call("correct_copilot_personal_wiki_fact_copilot_personal_wiki_correct_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Replace what the assistant believes with what is actually true.
+
+Different from `forget`: correcting keeps the fact and its provenance and
+changes its text, so the assistant knows it was wrong about THIS rather
+than knowing nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalWikiFactCorrectionRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiFactCorrectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.fact_id` | `string` | yes | min length 1, max length 255 |
+| `body.text` | `string` | yes | What is actually true. Replaces the fact's text. min length 1, max length 10000 |
+| `body.action_state` | `"open" \| "in_progress" \| "blocked" \| "completed" \| "cancelled" \| "informational" \| null` | no | For a fact the Copilot is tracking as a TO-DO rather than as a statement, move it to this state at the same time. Omit it for an ordinary correction. |
+| `body.reason` | `string \| null` | no | max length 2000 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.correctCopilotPersonalWikiFact({ body: { fact_id: "id", text: "example" } });
+```
+
+---
+
+<a id="op-createcopilotmemory"></a>
+
+### `g8.api.copilot.createCopilotMemory(input)`
+
+**Create Copilot Memory**
+
+- HTTP: `POST /api/v1/copilot/memory`
+- operationId: `create_copilot_memory_copilot_memory_post` (also callable as `g8.api.call("create_copilot_memory_copilot_memory_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Tell the Copilot something to remember.
+
+Takes a JSON BODY. The app takes `content` as a query parameter, which puts
+the text of a personal memory into the URL and therefore into access logs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `MemoryCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`MemoryCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content` | `string` | yes | What to remember, in the caller's own words. min length 1 |
+| `body.scope` | `string` | no | Who the memory belongs to. `user` - only this person's Copilot recalls it. Left an open string rather than a Literal because the handler treats an unknown scope as a label rather than an error, so closing it here would refuse a call the app accepts. default `"user"` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.createCopilotMemory({ body: { content: "example" } });
+```
+
+---
+
+<a id="op-deletecopilotmemory"></a>
+
+### `g8.api.copilot.deleteCopilotMemory(input)`
+
+**Delete Copilot Memory**
+
+- HTTP: `DELETE /api/v1/copilot/memory/{memory_id}`
+- operationId: `delete_copilot_memory_copilot_memory__memory_id__delete` (also callable as `g8.api.call("delete_copilot_memory_copilot_memory__memory_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `knowledge:delete`
+
+Forget one remembered fact. Not reversible.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.memory_id` | `string` | yes | Memory id. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `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.copilot.deleteCopilotMemory({ path: { memory_id: "id" } });
+```
+
+---
+
+<a id="op-editcopilotpersonalwikiitem"></a>
+
+### `g8.api.copilot.editCopilotPersonalWikiItem(input)`
+
+**Edit Copilot Personal Wiki Item**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/items/{item_id}`
+- operationId: `edit_copilot_personal_wiki_item_copilot_personal_wiki_items__item_id__put` (also callable as `g8.api.call("edit_copilot_personal_wiki_item_copilot_personal_wiki_items__item_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Edit one structured item in the wiki.
+
+`expected_revision` is REQUIRED and there is no unconditional form. The
+Copilot writes this document continuously, so an unguarded write is not a
+race between two people - it is a person silently discarding whatever the
+assistant learned between their read and their write.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.item_id` | `string` | yes | Wiki item id. |
+| `body` | `PersonalWikiItemEditRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiItemEditRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.document_id` | `string` | yes | min length 1, max length 100 |
+| `body.expected_revision` | `string` | yes | REQUIRED optimistic-concurrency token - a 64-character digest of the document you read. There is no unconditional write here, on purpose: the wiki is edited by the Copilot as well as by people, so a blind write would silently discard something it had just learned. min length 64, max length 64 |
+| `body.values` | `Record<string, unknown>` | yes | Field-by-field replacement for this item. Open-shaped because the item schema is per-section and defined by the wiki template. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.editCopilotPersonalWikiItem({
+  path: { item_id: "id" },
+  body: {
+    document_id: "id",
+    expected_revision: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    values: {},
+  },
+});
+```
+
+---
+
+<a id="op-forgetcopilotpersonalwikifact"></a>
+
+### `g8.api.copilot.forgetCopilotPersonalWikiFact(input)`
+
+**Forget Copilot Personal Wiki Fact**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/forget`
+- operationId: `forget_copilot_personal_wiki_fact_copilot_personal_wiki_forget_post` (also callable as `g8.api.call("forget_copilot_personal_wiki_fact_copilot_personal_wiki_forget_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Remove a fact from what the assistant knows.
+
+The per-fact privacy control, and the only one that actually unlearns -
+turning a SOURCE off stops new facts arriving but leaves the old ones.
+
+Send `reason`. It is the only record of why something was removed.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalWikiFactActionRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiFactActionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.fact_id` | `string` | yes | The fact. min length 1, max length 255 |
+| `body.reason` | `string \| null` | no | Why. Optional, and worth sending on a forget: it is the only record of why something was removed from what the Copilot knows. max length 2000 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.forgetCopilotPersonalWikiFact({ body: { fact_id: "id" } });
+```
+
+---
+
+<a id="op-getcopilotcontactsharing"></a>
+
+### `g8.api.copilot.getCopilotContactSharing(input?)`
+
+**Get Copilot Contact Sharing**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/contact-sharing`
+- operationId: `get_copilot_contact_sharing_copilot_personal_wiki_contact_sharing_get` (also callable as `g8.api.call("get_copilot_contact_sharing_copilot_personal_wiki_contact_sharing_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Which of your mailboxes contribute to the shared CRM, per mailbox.
+
+The setting; `/contributions` is the queue it produces.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotContactSharing();
+```
+
+---
+
+<a id="op-getcopilotlinkedinconnections"></a>
+
+### `g8.api.copilot.getCopilotLinkedinConnections(input?)`
+
+**Get Copilot Linkedin Connections**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/linkedin-connections`
+- operationId: `get_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_get` (also callable as `g8.api.call("get_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+The state of your LinkedIn connections import: settings, last run and
+its `revision` token.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotLinkedinConnections();
+```
+
+---
+
+<a id="op-getcopilotmemorycontext"></a>
+
+### `g8.api.copilot.getCopilotMemoryContext(input?)`
+
+**Get Copilot Memory Context**
+
+- HTTP: `GET /api/v1/copilot/memory/context`
+- operationId: `get_copilot_memory_context_copilot_memory_context_get` (also callable as `g8.api.call("get_copilot_memory_context_copilot_memory_context_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+The memory the Copilot would actually bring to a given conversation.
+
+Not the whole store - the ASSEMBLED context for a subject, which is what
+the assistant reasons from. The most useful read here when debugging "why
+did it say that": if a fact is not in this answer, it was not in front of
+the model.
+
+With no filters it returns the org and user level context alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.campaign_id` | `string \| null` | no | Narrow to one campaign. |
+| `query.company_id` | `string \| null` | no | Narrow to one company. |
+| `query.contact_id` | `string \| null` | no | Narrow to one contact. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotMemoryContext();
+```
+
+---
+
+<a id="op-getcopilotmemorydocuments"></a>
+
+### `g8.api.copilot.getCopilotMemoryDocuments(input)`
+
+**Get Copilot Memory Documents**
+
+- HTTP: `GET /api/v1/copilot/memory/documents`
+- operationId: `get_copilot_memory_documents_copilot_memory_documents_get` (also callable as `g8.api.call("get_copilot_memory_documents_copilot_memory_documents_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+The raw memory documents for one subject.
+
+`soul` is who they are, `memory` is durable fact, `daily` is the rolling
+journal. `GET /copilot/memory/context` is the assembled view; this is the
+source behind it, and the thing to edit.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.subject_type` | `string` | yes | organization \| user \| campaign \| company \| contact. |
+| `query.subject_id` | `string` | yes | Which one. |
+| `query.file_kind` | `string \| null` | no | `soul`, `memory` or `daily`. Omit for all three - they are different documents, not versions of one. |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotMemoryDocuments({ query: { subject_type: "Example", subject_id: "id" } });
+```
+
+---
+
+<a id="op-getcopilotpersonalwiki"></a>
+
+### `g8.api.copilot.getCopilotPersonalWiki(input?)`
+
+**Get Copilot Personal Wiki**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki`
+- operationId: `get_copilot_personal_wiki_copilot_personal_wiki_get` (also callable as `g8.api.call("get_copilot_personal_wiki_copilot_personal_wiki_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Everything the assistant believes about the person behind this key.
+
+Assembled from their email, calendar, documents and Work activity according
+to `GET /copilot/personal-wiki/sources`. Each fact carries where it came
+from, which is what makes a wrong one correctable rather than merely
+annoying.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotPersonalWiki();
+```
+
+---
+
+<a id="op-getcopilotpersonalwikidocument"></a>
+
+### `g8.api.copilot.getCopilotPersonalWikiDocument(input)`
+
+**Get Copilot Personal Wiki Document**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/documents/{section}`
+- operationId: `get_copilot_personal_wiki_document_copilot_personal_wiki_documents__section__get` (also callable as `g8.api.call("get_copilot_personal_wiki_document_copilot_personal_wiki_documents__section__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+One source document behind a section of the wiki.
+
+The evidence view: the actual text a section was derived from, rather than
+the assistant's summary of it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.section` | `string` | yes | Wiki section. |
+| `query.document_id` | `string` | yes | Which source document. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotPersonalWikiDocument({ path: { section: "example" }, query: { document_id: "id" } });
+```
+
+---
+
+<a id="op-getcopilotpersonalwikirelationship"></a>
+
+### `g8.api.copilot.getCopilotPersonalWikiRelationship(input)`
+
+**Get Copilot Personal Wiki Relationship**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/relationships/{contact_id}`
+- operationId: `get_copilot_personal_wiki_relationship_copilot_personal_wiki_relationships__contact_id__get` (also callable as `g8.api.call("get_copilot_personal_wiki_relationship_copilot_personal_wiki_relationships__contact_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+What the assistant knows about your relationship with ONE person.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contact_id` | `integer` | yes | CRM contact id (integer). |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotPersonalWikiRelationship({ path: { contact_id: 123 } });
+```
+
+---
+
+<a id="op-getcopilotpersonalwikisources"></a>
+
+### `g8.api.copilot.getCopilotPersonalWikiSources(input?)`
+
+**Get Copilot Personal Wiki Sources**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/sources`
+- operationId: `get_copilot_personal_wiki_sources_copilot_personal_wiki_sources_get` (also callable as `g8.api.call("get_copilot_personal_wiki_sources_copilot_personal_wiki_sources_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Which of your things the assistant is reading.
+
+Mailboxes, calendar, documents, Work. The privacy answer for this whole
+surface - what the wiki knows follows directly from what is switched on
+here.
+
+**Input**: none.
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.getCopilotPersonalWikiSources();
+```
+
+---
+
+<a id="op-listcopilotcontactcontributions"></a>
+
+### `g8.api.copilot.listCopilotContactContributions(input?)`
+
+**List Copilot Contact Contributions**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/contact-sharing/contributions`
+- operationId: `list_copilot_contact_contributions_copilot_personal_wiki_contact_sharing_contributions_get` (also callable as `g8.api.call("list_copilot_contact_contributions_copilot_personal_wiki_contact_sharing_contributions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+What your mailbox is offering to the shared CRM record, pending review.
+
+A contribution is a fact the assistant learned privately that WOULD change
+a shared contact - a new job title, a corrected name. It is held here until
+someone decides, rather than being written straight through.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.offset` | `integer` | no | default `0` |
+| `query.limit` | `integer` | no | default `25` |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.listCopilotContactContributions();
+```
+
+---
+
+<a id="op-listcopilotcontactmatches"></a>
+
+### `g8.api.copilot.listCopilotContactMatches(input)`
+
+**List Copilot Contact Matches**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/matches`
+- operationId: `list_copilot_contact_matches_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_get` (also callable as `g8.api.call("list_copilot_contact_matches_copilot_personal_wiki_contact_sharing_contributions__contribution_id__matches_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Which CRM contacts this contribution might be about.
+
+Read this before resolving one. A contribution that matches several people
+is a contribution whose decision would otherwise land on whichever the
+matcher guessed.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contribution_id` | `string` | yes | Contribution id (UUID). |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.listCopilotContactMatches({ path: { contribution_id: "id" } });
+```
+
+---
+
+<a id="op-listcopilotmemories"></a>
+
+### `g8.api.copilot.listCopilotMemories(input?)`
+
+**List Copilot Memories**
+
+- HTTP: `GET /api/v1/copilot/memory`
+- operationId: `list_copilot_memories_copilot_memory_get` (also callable as `g8.api.call("list_copilot_memories_copilot_memory_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Discrete things the Copilot has been told to remember.
+
+NOT the same store as `GET /agent/memory`, which is the agent runtime's
+planner state. These are the assistant's own remembered facts.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.scope` | `string \| null` | no | Filter to one memory scope. |
+| `query.limit` | `integer` | no | Page size. default `20` |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.listCopilotMemories();
+```
+
+---
+
+<a id="op-listcopilotpersonalwikirelationships"></a>
+
+### `g8.api.copilot.listCopilotPersonalWikiRelationships(input?)`
+
+**List Copilot Personal Wiki Relationships**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/relationships`
+- operationId: `list_copilot_personal_wiki_relationships_copilot_personal_wiki_relationships_get` (also callable as `g8.api.call("list_copilot_personal_wiki_relationships_copilot_personal_wiki_relationships_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Who the assistant thinks you know, and how well.
+
+Filtered by the key's CONTACT SCOPE, not just by org: a key whose user may
+only see their own contacts sees relationships to those contacts. The
+relationship graph is derived from a person's mailbox, so it is exactly the
+data that must not cross a rep boundary.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.item_id` | `string \| null` | no |  |
+| `query.query` | `string` | no | Substring match on the person. default `""` |
+| `query.sort` | `"recent" \| "name" \| "email"` | no | `recent`, `name` or `email`. default `"recent"` |
+| `query.offset` | `integer` | no | default `0` |
+| `query.limit` | `integer` | no | default `50` |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.listCopilotPersonalWikiRelationships();
+```
+
+---
+
+<a id="op-listcopilottools"></a>
+
+### `g8.api.copilot.listCopilotTools(input?)`
+
+**List Copilot Tools**
+
+- HTTP: `GET /api/v1/copilot/tools`
+- operationId: `list_copilot_tools_copilot_tools_get` (also callable as `g8.api.call("list_copilot_tools_copilot_tools_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+The tools the copilot can call, and which of them need a person's approval. FREE.
+
+**Input**: none.
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.listCopilotTools();
+```
+
+---
+
+<a id="op-previewcopilotpersonalwikidriveselection"></a>
+
+### `g8.api.copilot.previewCopilotPersonalWikiDriveSelection(input)`
+
+**Preview Copilot Personal Wiki Drive Selection**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/drive-selection/preview`
+- operationId: `preview_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_preview_post` (also callable as `g8.api.call("preview_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_preview_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+What a Drive selection WOULD read, without saving it.
+
+POST only because the selection is a body; it changes nothing. Returns a
+`fingerprint` to hand to the save, so the save is refused if the folders
+have changed underneath you in between.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalDriveSelectionRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalDriveSelectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.mailbox_id` | `integer` | yes | Integer `mailboxes.id` of the connected Google account. > 0 |
+| `body.document_ids` | `Array<string>` | no | Individual Drive documents to read. max items 20 |
+| `body.folders` | `Array<PersonalDriveFolderChoice>` | no | Whole folders to read. max items 10 |
+| `body.preview_fingerprint` | `string \| null` | no | The `fingerprint` from the preview call. When sent, the save is refused (409) if the selection no longer resolves to what you previewed. pattern `^[a-f0-9]{64}$` |
+| `body.revision` | `string \| null` | no | The sources' `updated_at` from `GET /copilot/personal-wiki/sources`. A mismatch is a 409: someone else changed the selection since you read it. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.previewCopilotPersonalWikiDriveSelection({ body: { mailbox_id: 1 } });
+```
+
+---
+
+<a id="op-promotecopilotmemory"></a>
+
+### `g8.api.copilot.promoteCopilotMemory(input)`
+
+**Promote Copilot Memory**
+
+- HTTP: `POST /api/v1/copilot/memory/promote`
+- operationId: `promote_copilot_memory_copilot_memory_promote_post` (also callable as `g8.api.call("promote_copilot_memory_copilot_memory_promote_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `knowledge:run`
+
+Promote what is worth keeping out of the daily journal into durable
+memory.
+
+The garbage-collection step of the whole memory design. Without it the
+journal grows without bound and the durable documents stay empty, so the
+assistant ends up with a great deal of noise and very little knowledge.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PromoteMemoryRequest` | yes | Request body; fields below. |
+
+Body fields (`PromoteMemoryRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.subject_id` | `string` | yes | Which one. |
+| `body.subject_type` | `string` | yes | organization \| user \| campaign \| company \| contact. |
+| `body.days_back` | `integer` | no | How far back through the daily journal to look for things worth keeping. Promotion is what stops the journal growing forever and the durable memory staying empty. default `7` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `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.copilot.promoteCopilotMemory({ body: { subject_id: "id", subject_type: "Example" } });
+```
+
+---
+
+<a id="op-resolvecopilotcontactcontribution"></a>
+
+### `g8.api.copilot.resolveCopilotContactContribution(input)`
+
+**Resolve Copilot Contact Contribution**
+
+- HTTP: `POST /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/resolve`
+- operationId: `resolve_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__resolve_post` (also callable as `g8.api.call("resolve_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__resolve_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Decide ONE FIELD of a contribution: keep the CRM value, or take the
+proposed one.
+
+Per field rather than per contribution, because a contribution can be right
+about a job title and wrong about a surname.
+
+TWO concurrency tokens are required and both are load-bearing: one for the
+contribution and one for the CANONICAL contact record the decision would
+change. Either having moved means the decision was made against something
+that no longer holds, and `use_proposed` OVERWRITES a shared record.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contribution_id` | `string` | yes | Contribution id (UUID). |
+| `body` | `PersonalContactReviewRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactReviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.choice` | `"keep_current" \| "use_proposed"` | yes | `keep_current` - the CRM record wins. `use_proposed` - the contributed value wins and overwrites it. |
+| `body.expected_canonical_revision` | `string` | yes | Digest of the CANONICAL contact record as you read it. Two tokens are required because two records are in play: the contribution and the contact it would change. Either moving means the decision was made against something that no longer holds. min length 64, max length 64 |
+| `body.expected_revision` | `integer` | yes | The contribution's revision. min 1 |
+| `body.field` | `"CONTACT_FIRST_NAME" \| "CONTACT_LAST_NAME" \| "CONTACT_JOB_TITLE"` | yes | Which field is being decided. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.resolveCopilotContactContribution({
+  path: { contribution_id: "id" },
+  body: {
+    choice: "keep_current",
+    expected_canonical_revision: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    expected_revision: 1,
+    field: "CONTACT_FIRST_NAME",
+  },
+});
+```
+
+---
+
+<a id="op-runcopilotlandingpageaction"></a>
+
+### `g8.api.copilot.runCopilotLandingPageAction(input)`
+
+**Run Copilot Landing Page Action**
+
+- HTTP: `POST /api/v1/copilot/landing-page-action`
+- operationId: `run_copilot_landing_page_action_copilot_landing_page_action_post` (also callable as `g8.api.call("run_copilot_landing_page_action_copilot_landing_page_action_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `knowledge:run`
+
+Add, remove, reorder or AI-edit a landing page's sections. `edit_section` SPENDS CREDIT.
+
+`add_section`, `remove_section` and `reorder_sections` are deterministic.
+Returns the updated page.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CopilotLandingPageActionRequest` | yes | Request body; fields below. |
+
+Body fields (`CopilotLandingPageActionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.action_type` | `"edit_section" \| "add_section" \| "remove_section" \| "reorder_sections"` | yes |  |
+| `body.landing_page_id` | `string` | yes |  |
+| `body.instruction` | `string \| null` | no | For edit_section. |
+| `body.new_order` | `Array<integer> \| null` | no | For reorder_sections: the new index order. |
+| `body.new_section_type` | `string \| null` | no | For add_section. |
+| `body.section_idx` | `integer \| null` | no | For edit_section and remove_section. |
+| `body.selected_text` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_StudioContentPayload_`: the envelope `{ data: StudioContentPayload, ... }`. `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.copilot.runCopilotLandingPageAction({ body: { action_type: "edit_section", landing_page_id: "id" } });
+```
+
+---
+
+<a id="op-savecopilotpersonalwikidriveselection"></a>
+
+### `g8.api.copilot.saveCopilotPersonalWikiDriveSelection(input)`
+
+**Save Copilot Personal Wiki Drive Selection**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/drive-selection`
+- operationId: `save_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_put` (also callable as `g8.api.call("save_copilot_personal_wiki_drive_selection_copilot_personal_wiki_drive_selection_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Save which Drive documents and folders the Copilot may read.
+
+Replaces the Drive part of the selection. `revision` is required in
+practice: it must equal the sources' current `updated_at`, or the save is
+a 409.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalDriveSelectionRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalDriveSelectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.mailbox_id` | `integer` | yes | Integer `mailboxes.id` of the connected Google account. > 0 |
+| `body.document_ids` | `Array<string>` | no | Individual Drive documents to read. max items 20 |
+| `body.folders` | `Array<PersonalDriveFolderChoice>` | no | Whole folders to read. max items 10 |
+| `body.preview_fingerprint` | `string \| null` | no | The `fingerprint` from the preview call. When sent, the save is refused (409) if the selection no longer resolves to what you previewed. pattern `^[a-f0-9]{64}$` |
+| `body.revision` | `string \| null` | no | The sources' `updated_at` from `GET /copilot/personal-wiki/sources`. A mismatch is a 409: someone else changed the selection since you read it. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.saveCopilotPersonalWikiDriveSelection({ body: { mailbox_id: 1 } });
+```
+
+---
+
+<a id="op-searchcopilotcontactidentities"></a>
+
+### `g8.api.copilot.searchCopilotContactIdentities(input)`
+
+**Search Copilot Contact Identities**
+
+- HTTP: `GET /api/v1/copilot/personal-wiki/contact-identities`
+- operationId: `search_copilot_contact_identities_copilot_personal_wiki_contact_identities_get` (also callable as `g8.api.call("search_copilot_contact_identities_copilot_personal_wiki_contact_identities_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Find the CRM contact a wiki fact is really about.
+
+The lookup behind `POST /copilot/personal-wiki/relationships/identity`. The
+two-character minimum is the app's and is real: it is a scoped search over
+people, not a prefix index.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.query` | `string` | yes | At least two characters. |
+
+**Returns** `ApiResponse_CopilotMemoryListPayload_`: the envelope `{ data: CopilotMemoryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`CopilotMemoryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.searchCopilotContactIdentities({ query: { query: "example" } });
+```
+
+---
+
+<a id="op-searchcopilotmentions"></a>
+
+### `g8.api.copilot.searchCopilotMentions(input)`
+
+**Search Copilot Mentions**
+
+- HTTP: `POST /api/v1/copilot/mention-search`
+- operationId: `search_copilot_mentions_copilot_mention_search_post` (also callable as `g8.api.call("search_copilot_mentions_copilot_mention_search_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `knowledge:read`
+
+Find what can be @mentioned: documents, personas, ICPs, campaigns, teammates. FREE.
+
+Read-only. Pass results as `mentions` on `POST /copilot/chat`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CopilotMentionSearchRequest` | yes | Request body; fields below. |
+
+Body fields (`CopilotMentionSearchRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.campaign_id` | `string \| null` | no |  |
+| `body.mode` | `"global" \| "campaign" \| "account" \| null` | no |  |
+| `body.query` | `string` | no | default `""` |
+
+**Returns** `ApiResponse_StudioContentListPayload_`: the envelope `{ data: StudioContentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`StudioContentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.searchCopilotMentions({ body: {} });
+```
+
+---
+
+<a id="op-updatecopilotcontactcontribution"></a>
+
+### `g8.api.copilot.updateCopilotContactContribution(input)`
+
+**Update Copilot Contact Contribution**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}`
+- operationId: `update_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__put` (also callable as `g8.api.call("update_copilot_contact_contribution_copilot_personal_wiki_contact_sharing_contributions__contribution_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Turn ONE contribution on or off.
+
+`expected_revision` is required. This decides whether private knowledge
+becomes org-wide, so a blind write could re-enable sharing somebody had
+just switched off.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contribution_id` | `string` | yes | Contribution id (UUID). |
+| `body` | `PersonalContactSharingRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactSharingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.enabled` | `boolean` | yes | Whether what this mailbox knows about a contact is contributed to the organisation's shared CRM record. Explicit rather than a toggle, so a retry is idempotent instead of switching it back. |
+| `body.expected_revision` | `integer` | yes | REQUIRED optimistic-concurrency token. Sharing settings decide whether one person's private contact knowledge becomes org-wide, so there is no unconditional write: a blind one could re-enable sharing somebody had just turned off. min 0 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotContactContribution({
+  path: { contribution_id: "id" },
+  body: { enabled: true, expected_revision: 0 },
+});
+```
+
+---
+
+<a id="op-updatecopilotcontactpeoplechoice"></a>
+
+### `g8.api.copilot.updateCopilotContactPeopleChoice(input)`
+
+**Update Copilot Contact People Choice**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/contact-sharing/people/choice`
+- operationId: `update_copilot_contact_people_choice_copilot_personal_wiki_contact_sharing_people_choice_put` (also callable as `g8.api.call("update_copilot_contact_people_choice_copilot_personal_wiki_contact_sharing_people_choice_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Keep specific people private, share them, or let them follow the
+mailbox default.
+
+The per-person override on top of `PUT /copilot/personal-wiki/contact-sharing/{mailbox_id}`.
+`expected_revision` is required.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalContactChoiceRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactChoiceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.expected_revision` | `integer` | yes | Concurrency token from the sharing GET. min 0 |
+| `body.mode` | `"default" \| "private" \| "shared"` | yes | `private` keeps these people to yourself, `shared` offers them to the org's CRM, `default` follows the mailbox-level setting. |
+| `body.connection_revisions` | `Record<string, integer>` | no | Per-connection revision tokens, keyed by connection id (UUID). |
+| `body.fact_ids` | `Array<string>` | no | The people (wiki facts) this choice applies to. max items 500 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotContactPeopleChoice({ body: { expected_revision: 0, mode: "default" } });
+```
+
+---
+
+<a id="op-updatecopilotcontactsharing"></a>
+
+### `g8.api.copilot.updateCopilotContactSharing(input)`
+
+**Update Copilot Contact Sharing**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/contact-sharing/{mailbox_id}`
+- operationId: `update_copilot_contact_sharing_copilot_personal_wiki_contact_sharing__mailbox_id__put` (also callable as `g8.api.call("update_copilot_contact_sharing_copilot_personal_wiki_contact_sharing__mailbox_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Turn contact sharing on or off for ONE mailbox.
+
+The switch that decides whether a person's private contact knowledge starts
+producing contributions at all. `expected_revision` is required.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.mailbox_id` | `integer` | yes | Integer `mailboxes.id` - the database primary key, not the cron-job string id. |
+| `body` | `PersonalContactSharingRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalContactSharingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.enabled` | `boolean` | yes | Whether what this mailbox knows about a contact is contributed to the organisation's shared CRM record. Explicit rather than a toggle, so a retry is idempotent instead of switching it back. |
+| `body.expected_revision` | `integer` | yes | REQUIRED optimistic-concurrency token. Sharing settings decide whether one person's private contact knowledge becomes org-wide, so there is no unconditional write: a blind one could re-enable sharing somebody had just turned off. min 0 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotContactSharing({
+  path: { mailbox_id: 123 },
+  body: { enabled: true, expected_revision: 0 },
+});
+```
+
+---
+
+<a id="op-updatecopilotlinkedinconnections"></a>
+
+### `g8.api.copilot.updateCopilotLinkedinConnections(input)`
+
+**Update Copilot Linkedin Connections**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/linkedin-connections`
+- operationId: `update_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_put` (also callable as `g8.api.call("update_copilot_linkedin_connections_copilot_personal_wiki_linkedin_connections_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Change the LinkedIn connections import settings, and optionally start
+an import (`start: true`).
+
+The import itself runs in the background; read its progress back with the
+GET. `expected_revision` is required.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalLinkedInImportRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalLinkedInImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.expected_revision` | `integer` | yes | The `revision` from the GET. A stale value is a 409. min 0 |
+| `body.keep_updated` | `boolean` | no | Re-import the connection list on a schedule. default `false` |
+| `body.share` | `boolean` | no | Offer what is learned from these connections to the shared CRM (reviewed first). default `false` |
+| `body.start` | `boolean` | no | Start an import now, rather than only saving the settings. default `false` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotLinkedinConnections({ body: { expected_revision: 0 } });
+```
+
+---
+
+<a id="op-updatecopilotpersonalwiki"></a>
+
+### `g8.api.copilot.updateCopilotPersonalWiki(input)`
+
+**Update Copilot Personal Wiki**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki`
+- operationId: `update_copilot_personal_wiki_copilot_personal_wiki_put` (also callable as `g8.api.call("update_copilot_personal_wiki_copilot_personal_wiki_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Replace the wiki document WHOLE.
+
+The blunt instrument. Prefer `confirm`, `correct` and `forget`, which act on
+ONE fact and leave its provenance intact - this replaces the document and
+the Copilot then has to re-derive what it knew.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalWikiUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content` | `string` | yes | The WHOLE wiki document. Replaces what is there. max length 100000 |
+| `body.title` | `string \| null` | no | max length 255 |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotPersonalWiki({ body: { content: "example" } });
+```
+
+---
+
+<a id="op-updatecopilotpersonalwikisources"></a>
+
+### `g8.api.copilot.updateCopilotPersonalWikiSources(input)`
+
+**Update Copilot Personal Wiki Sources**
+
+- HTTP: `PUT /api/v1/copilot/personal-wiki/sources`
+- operationId: `update_copilot_personal_wiki_sources_copilot_personal_wiki_sources_put` (also callable as `g8.api.call("update_copilot_personal_wiki_sources_copilot_personal_wiki_sources_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Change what the assistant may read.
+
+PARTIAL: an omitted field is left alone, an explicit one changes it. So
+omitting `email_enabled` and sending `false` are different instructions.
+
+SWITCHING A SOURCE OFF DOES NOT UNLEARN. It stops new facts arriving from
+there; what was already derived stays until it is forgotten one fact at a
+time through `POST /copilot/personal-wiki/forget`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonalWikiSourcesUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonalWikiSourcesUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.additional_mailbox_ids` | `Array<integer> \| null` | no | Further mailboxes to read. max items 20 |
+| `body.calendar_enabled` | `boolean \| null` | no | Read your calendar. |
+| `body.docs_enabled` | `boolean \| null` | no | Read the named documents. |
+| `body.document_ids` | `Array<string> \| null` | no | Which documents, when `docs_enabled`. max items 20 |
+| `body.email_enabled` | `boolean \| null` | no | Whether the Copilot reads your email to build the wiki. Turning this off stops new facts arriving from email; it does not remove what it already learned - use `POST /copilot/personal-wiki/forget` for that. |
+| `body.primary_mailbox_id` | `integer \| null` | no | The mailbox the wiki draws its email signal from. |
+| `body.work_enabled` | `boolean \| null` | no | Read your Work activity. |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.updateCopilotPersonalWikiSources({ body: {} });
+```
+
+---
+
+<a id="op-upsertcopilotmemorydocument"></a>
+
+### `g8.api.copilot.upsertCopilotMemoryDocument(input)`
+
+**Upsert Copilot Memory Document**
+
+- HTTP: `PUT /api/v1/copilot/memory/documents`
+- operationId: `upsert_copilot_memory_document_copilot_memory_documents_put` (also callable as `g8.api.call("upsert_copilot_memory_document_copilot_memory_documents_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `knowledge:write`
+
+Write a memory document WHOLE. This replaces, it does not merge.
+
+`visibility` defaults to `shared`, which means the whole organisation's
+Copilot may draw on it. That is the app's default and it is the wider of
+the two, so it is what you get by not thinking about it - worth thinking
+about it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `MemoryDocumentRequest` | yes | Request body; fields below. |
+
+Body fields (`MemoryDocumentRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content` | `string` | yes | The WHOLE document. This is an upsert, not an append: it replaces what is there. Use `POST /copilot/memory/documents/append` to add without replacing. |
+| `body.file_kind` | `string` | yes | `soul` - who the subject is. `memory` - durable facts. `daily` - the rolling journal. |
+| `body.subject_id` | `string` | yes | Which one. |
+| `body.subject_type` | `string` | yes | organization \| user \| campaign \| company \| contact. |
+| `body.title` | `string \| null` | no | Display title. |
+| `body.visibility` | `string` | no | `shared` - the whole org's Copilot may draw on it. Defaults to shared, matching the app, so a document written without thinking about this is visible org-wide. default `"shared"` |
+
+**Returns** `ApiResponse_CopilotMemoryPayload_`: the envelope `{ data: CopilotMemoryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.copilot.upsertCopilotMemoryDocument({
+  body: {
+    content: "example",
+    file_kind: "example",
+    subject_id: "id",
+    subject_type: "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-copilotcanvascontext"></a>
+
+### `CopilotCanvasContext`
+
+What the copilot is looking at: a document, a selection, a campaign or account.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `accountId` | `string \| null` | no |  |
+| `activeDocument` | `Record<string, unknown> \| null` | no | {path, content, type, status}. |
+| `campaignId` | `string \| null` | no |  |
+| `cursor` | `Record<string, integer> \| null` | no | {line, column}. |
+| `mode` | `"global" \| "campaign" \| "account"` | no | default `"global"` |
+| `selection` | `Record<string, unknown> \| null` | no | {text, start_line, end_line}. |
+
+<a id="type-copilotchatmessage"></a>
+
+### `CopilotChatMessage`
+
+One earlier turn of the conversation.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `content` | `string` | yes |  |
+| `role` | `"user" \| "assistant" \| "system" \| "tool"` | yes |  |
+| `tool_name` | `string \| null` | no |  |
+| `tool_result` | `Record<string, unknown> \| null` | no |  |
+
+<a id="type-personaldrivefolderchoice"></a>
+
+### `PersonalDriveFolderChoice`
+
+Mirror of `PersonalDriveFolderChoice`.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes | Drive folder id, as returned by `GET /copilot/personal-wiki/drive`. pattern `^[A-Za-z0-9_-]{10,200}$` |
+| `auto_sync` | `boolean` | no | Keep reading new documents added to this folder later, not just today's. default `false` |