@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/gtmLibrary.md

@@ -0,0 +1,780 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.gtmLibrary`: GTM Library
+
+20 operations (4 read, 9 write, 3 destructive, 4 billable).
+
+No hand-written client covers this area. Call it through `g8.api.gtmLibrary.*` 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: [gtmLibrary.d.ts](gtmLibrary.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`createCommittee`](#op-createcommittee) | `POST /api/v1/committees` | write | `campaigns:write` | Create Committee |
+| [`deleteCommittee`](#op-deletecommittee) | `DELETE /api/v1/committees/{committee_id}` | destructive | `campaigns:delete` | Delete Committee |
+| [`deletePersona`](#op-deletepersona) | `DELETE /api/v1/personas/{persona_id}` | destructive | `campaigns:delete` | Delete Persona |
+| [`deleteTam`](#op-deletetam) | `DELETE /api/v1/tam` | destructive | `campaigns:delete` | Delete Tam |
+| [`fillPersonasFromGlobalDoc`](#op-fillpersonasfromglobaldoc) | `POST /api/v1/personas/from-global-doc` | write | `campaigns:write` | Fill Personas From Global Doc |
+| [`generateIcps`](#op-generateicps) | `POST /api/v1/icps/generate` | billable | `campaigns:run` | Generate Icps |
+| [`generatePersonas`](#op-generatepersonas) | `POST /api/v1/personas/generate` | billable | `campaigns:run` | Generate Personas |
+| [`generateTam`](#op-generatetam) | `POST /api/v1/tam/generate` | billable | `campaigns:run` | Generate Tam |
+| [`getCommittee`](#op-getcommittee) | `GET /api/v1/committees/{committee_id}` | read | `campaigns:read` | Get Committee |
+| [`getPersona`](#op-getpersona) | `GET /api/v1/personas/{persona_id}` | read | `campaigns:read` | Get Persona |
+| [`getTam`](#op-gettam) | `GET /api/v1/tam` | read | `campaigns:read` | Get Tam |
+| [`listCommittees`](#op-listcommittees) | `GET /api/v1/committees` | read | `campaigns:read` | List Committees |
+| [`pinIcp`](#op-pinicp) | `POST /api/v1/icps/{icp_id}/pin` | write | `campaigns:write` | Pin Icp |
+| [`pinPersona`](#op-pinpersona) | `POST /api/v1/personas/{persona_id}/pin` | write | `campaigns:write` | Pin Persona |
+| [`regenerateTam`](#op-regeneratetam) | `POST /api/v1/tam/regenerate` | billable | `campaigns:run` | Regenerate Tam |
+| [`replaceCommitteeMembers`](#op-replacecommitteemembers) | `PUT /api/v1/committees/{committee_id}/members` | write | `campaigns:write` | Replace Committee Members |
+| [`unpinIcp`](#op-unpinicp) | `POST /api/v1/icps/{icp_id}/unpin` | write | `campaigns:write` | Unpin Icp |
+| [`unpinPersona`](#op-unpinpersona) | `POST /api/v1/personas/{persona_id}/unpin` | write | `campaigns:write` | Unpin Persona |
+| [`updateCommittee`](#op-updatecommittee) | `PATCH /api/v1/committees/{committee_id}` | write | `campaigns:write` | Update Committee |
+| [`updateTam`](#op-updatetam) | `PATCH /api/v1/tam` | write | `campaigns:write` | Update Tam |
+
+---
+
+<a id="op-createcommittee"></a>
+
+### `g8.api.gtmLibrary.createCommittee(input)`
+
+**Create Committee**
+
+- HTTP: `POST /api/v1/committees`
+- operationId: `create_committee_committees_post` (also callable as `g8.api.call("create_committee_committees_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Create a buying committee.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CommitteeCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`CommitteeCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes |  |
+| `body.description` | `string \| null` | no |  |
+| `body.is_default` | `boolean \| null` | no | Make this the org's default committee (unsets the previous one). default `false` |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.createCommittee({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-deletecommittee"></a>
+
+### `g8.api.gtmLibrary.deleteCommittee(input)`
+
+**Delete Committee**
+
+- HTTP: `DELETE /api/v1/committees/{committee_id}`
+- operationId: `delete_committee_committees__committee_id__delete` (also callable as `g8.api.call("delete_committee_committees__committee_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a committee. Its member rows go with it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.committee_id` | `string (uuid)` | yes | Committee id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `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.gtmLibrary.deleteCommittee({ path: { committee_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-deletepersona"></a>
+
+### `g8.api.gtmLibrary.deletePersona(input)`
+
+**Delete Persona**
+
+- HTTP: `DELETE /api/v1/personas/{persona_id}`
+- operationId: `delete_persona_personas__persona_id__delete` (also callable as `g8.api.call("delete_persona_personas__persona_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Permanently delete a persona. `POST /personas/{id}/archive` is the reversible option.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.persona_id` | `string` | yes | Persona id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `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.gtmLibrary.deletePersona({ path: { persona_id: "id" } });
+```
+
+---
+
+<a id="op-deletetam"></a>
+
+### `g8.api.gtmLibrary.deleteTam(input?)`
+
+**Delete Tam**
+
+- HTTP: `DELETE /api/v1/tam`
+- operationId: `delete_tam_tam_delete` (also callable as `g8.api.call("delete_tam_tam_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a TAM definition.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.website_url` | `string \| null` | no | Which website's TAM to delete. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `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.gtmLibrary.deleteTam();
+```
+
+---
+
+<a id="op-fillpersonasfromglobaldoc"></a>
+
+### `g8.api.gtmLibrary.fillPersonasFromGlobalDoc(input?)`
+
+**Fill Personas From Global Doc**
+
+- HTTP: `POST /api/v1/personas/from-global-doc`
+- operationId: `fill_personas_from_global_doc_personas_from_global_doc_post` (also callable as `g8.api.call("fill_personas_from_global_doc_personas_from_global_doc_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Create or complete personas from the finished persona-research document.
+
+Idempotent. A persona with a committee role already set is left alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonaFillFromDocRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.website_url` | `string \| null` | no | Stored on any persona row this creates. Optional: the committees view is org-wide and does not filter on it. |
+
+**Returns** `ApiResponse_GtmLibraryListPayload_`: the envelope `{ data: GtmLibraryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`GtmLibraryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.fillPersonasFromGlobalDoc();
+```
+
+---
+
+<a id="op-generateicps"></a>
+
+### `g8.api.gtmLibrary.generateIcps(input)`
+
+**Generate Icps**
+
+- HTTP: `POST /api/v1/icps/generate`
+- operationId: `generate_icps_icps_generate_post` (also callable as `g8.api.call("generate_icps_icps_generate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Research ideal customer profiles for a website with AI (runs a model; billable).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `IcpGenerateRequest` | yes | Request body; fields below. |
+
+Body fields (`IcpGenerateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.website_url` | `string` | yes | The website the ICPs are researched from. |
+| `body.save_to_database` | `boolean \| null` | no | Persist the generated ICPs. default `true` |
+
+**Returns** `ApiResponse_GtmLibraryListPayload_`: the envelope `{ data: GtmLibraryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`GtmLibraryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.gtmLibrary.generateIcps({ body: { website_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-generatepersonas"></a>
+
+### `g8.api.gtmLibrary.generatePersonas(input)`
+
+**Generate Personas**
+
+- HTTP: `POST /api/v1/personas/generate`
+- operationId: `generate_personas_personas_generate_post` (also callable as `g8.api.call("generate_personas_personas_generate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Research buyer personas for a website with AI (runs a model; billable).
+
+Pinned personas survive; unpinned ones are replaced when saved.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PersonaGenerateRequest` | yes | Request body; fields below. |
+
+Body fields (`PersonaGenerateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.website_url` | `string` | yes | The website the personas are researched from. |
+| `body.save_to_database` | `boolean \| null` | no | Persist the generated personas. False returns a preview only. default `true` |
+
+**Returns** `ApiResponse_GtmLibraryListPayload_`: the envelope `{ data: GtmLibraryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`GtmLibraryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.gtmLibrary.generatePersonas({ body: { website_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-generatetam"></a>
+
+### `g8.api.gtmLibrary.generateTam(input)`
+
+**Generate Tam**
+
+- HTTP: `POST /api/v1/tam/generate`
+- operationId: `generate_tam_tam_generate_post` (also callable as `g8.api.call("generate_tam_tam_generate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Define the TAM for a website with AI (runs a model; billable).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `TamGenerateRequest` | yes | Request body; fields below. |
+
+Body fields (`TamGenerateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.website_url` | `string` | yes | The website the TAM is defined for. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `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.gtmLibrary.generateTam({ body: { website_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-getcommittee"></a>
+
+### `g8.api.gtmLibrary.getCommittee(input)`
+
+**Get Committee**
+
+- HTTP: `GET /api/v1/committees/{committee_id}`
+- operationId: `get_committee_committees__committee_id__get` (also callable as `g8.api.call("get_committee_committees__committee_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+A committee with its full member roster.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.committee_id` | `string (uuid)` | yes | Committee id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.getCommittee({ path: { committee_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-getpersona"></a>
+
+### `g8.api.gtmLibrary.getPersona(input)`
+
+**Get Persona**
+
+- HTTP: `GET /api/v1/personas/{persona_id}`
+- operationId: `get_persona_personas__persona_id__get` (also callable as `g8.api.call("get_persona_personas__persona_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One persona.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.persona_id` | `string` | yes | Persona id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.getPersona({ path: { persona_id: "id" } });
+```
+
+---
+
+<a id="op-gettam"></a>
+
+### `g8.api.gtmLibrary.getTam(input?)`
+
+**Get Tam**
+
+- HTTP: `GET /api/v1/tam`
+- operationId: `get_tam_tam_get` (also callable as `g8.api.call("get_tam_tam_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's total-addressable-market definition.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.website_url` | `string \| null` | no | Which website's TAM. Omit for the org's latest. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.getTam();
+```
+
+---
+
+<a id="op-listcommittees"></a>
+
+### `g8.api.gtmLibrary.listCommittees(input?)`
+
+**List Committees**
+
+- HTTP: `GET /api/v1/committees`
+- operationId: `list_committees_committees_get` (also callable as `g8.api.call("list_committees_committees_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every buying committee in the org, with member counts.
+
+**Input**: none.
+
+**Returns** `ApiResponse_GtmLibraryListPayload_`: the envelope `{ data: GtmLibraryListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`GtmLibraryListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.listCommittees();
+```
+
+---
+
+<a id="op-pinicp"></a>
+
+### `g8.api.gtmLibrary.pinIcp(input)`
+
+**Pin Icp**
+
+- HTTP: `POST /api/v1/icps/{icp_id}/pin`
+- operationId: `pin_icp_icps__icp_id__pin_post` (also callable as `g8.api.call("pin_icp_icps__icp_id__pin_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Pin an ICP so `POST /icps/generate` keeps it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.icp_id` | `string` | yes | ICP id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.pinIcp({ path: { icp_id: "id" } });
+```
+
+---
+
+<a id="op-pinpersona"></a>
+
+### `g8.api.gtmLibrary.pinPersona(input)`
+
+**Pin Persona**
+
+- HTTP: `POST /api/v1/personas/{persona_id}/pin`
+- operationId: `pin_persona_personas__persona_id__pin_post` (also callable as `g8.api.call("pin_persona_personas__persona_id__pin_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Pin a persona so `POST /personas/generate` keeps it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.persona_id` | `string` | yes | Persona id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.pinPersona({ path: { persona_id: "id" } });
+```
+
+---
+
+<a id="op-regeneratetam"></a>
+
+### `g8.api.gtmLibrary.regenerateTam(input)`
+
+**Regenerate Tam**
+
+- HTTP: `POST /api/v1/tam/regenerate`
+- operationId: `regenerate_tam_tam_regenerate_post` (also callable as `g8.api.call("regenerate_tam_tam_regenerate_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Re-run the TAM definition with AI (runs a model; billable).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `TamGenerateRequest` | yes | Request body; fields below. |
+
+Body fields (`TamGenerateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.website_url` | `string` | yes | The website the TAM is defined for. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `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.gtmLibrary.regenerateTam({ body: { website_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-replacecommitteemembers"></a>
+
+### `g8.api.gtmLibrary.replaceCommitteeMembers(input)`
+
+**Replace Committee Members**
+
+- HTTP: `PUT /api/v1/committees/{committee_id}/members`
+- operationId: `replace_committee_members_committees__committee_id__members_put` (also callable as `g8.api.call("replace_committee_members_committees__committee_id__members_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Replace the committee's whole roster in one write.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.committee_id` | `string (uuid)` | yes | Committee id. |
+| `body` | `CommitteeMembersRequest` | yes | Request body; fields below. |
+
+Body fields (`CommitteeMembersRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.members` | `Array<CommitteeMemberAssignment>` | yes | The FULL roster. Personas left out are removed from the committee. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.replaceCommitteeMembers({
+  path: { committee_id: "00000000-0000-0000-0000-000000000000" },
+  body: { members: [{ persona_id: "id" }] },
+});
+```
+
+---
+
+<a id="op-unpinicp"></a>
+
+### `g8.api.gtmLibrary.unpinIcp(input)`
+
+**Unpin Icp**
+
+- HTTP: `POST /api/v1/icps/{icp_id}/unpin`
+- operationId: `unpin_icp_icps__icp_id__unpin_post` (also callable as `g8.api.call("unpin_icp_icps__icp_id__unpin_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Unpin an ICP; the next generation may replace it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.icp_id` | `string` | yes | ICP id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.unpinIcp({ path: { icp_id: "id" } });
+```
+
+---
+
+<a id="op-unpinpersona"></a>
+
+### `g8.api.gtmLibrary.unpinPersona(input)`
+
+**Unpin Persona**
+
+- HTTP: `POST /api/v1/personas/{persona_id}/unpin`
+- operationId: `unpin_persona_personas__persona_id__unpin_post` (also callable as `g8.api.call("unpin_persona_personas__persona_id__unpin_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Unpin a persona; the next generation may replace it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.persona_id` | `string` | yes | Persona id. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.unpinPersona({ path: { persona_id: "id" } });
+```
+
+---
+
+<a id="op-updatecommittee"></a>
+
+### `g8.api.gtmLibrary.updateCommittee(input)`
+
+**Update Committee**
+
+- HTTP: `PATCH /api/v1/committees/{committee_id}`
+- operationId: `update_committee_committees__committee_id__patch` (also callable as `g8.api.call("update_committee_committees__committee_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Rename a committee, edit its description, or make it the default.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.committee_id` | `string (uuid)` | yes | Committee id. |
+| `body` | `CommitteeUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`CommitteeUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no |  |
+| `body.is_default` | `boolean \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.updateCommittee({
+  path: { committee_id: "00000000-0000-0000-0000-000000000000" },
+  body: {},
+});
+```
+
+---
+
+<a id="op-updatetam"></a>
+
+### `g8.api.gtmLibrary.updateTam(input)`
+
+**Update Tam**
+
+- HTTP: `PATCH /api/v1/tam`
+- operationId: `update_tam_tam_patch` (also callable as `g8.api.call("update_tam_tam_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Replace the TAM definition. Records a new version authored by the key.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `TamUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`TamUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.definition` | `Record<string, unknown>` | yes | The full TAM definition to store. |
+| `body.website_url` | `string` | yes | The website whose TAM definition is edited. |
+| `body.change_summary` | `string \| null` | no | A note recorded with the new version. |
+
+**Returns** `ApiResponse_GtmLibraryPayload_`: the envelope `{ data: GtmLibraryPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.gtmLibrary.updateTam({ body: { definition: {}, website_url: "https://example.com" } });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-committeememberassignment"></a>
+
+### `CommitteeMemberAssignment`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `persona_id` | `string` | yes |  |
+| `abm_category` | `"economic_buyer" \| "champion" \| "end_user" \| "technical" \| null` | no | The role slot. Null keeps the persona on the committee with no role. |