@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/content.md

@@ -0,0 +1,1667 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.content`: Content
+
+41 operations (18 read, 10 write, 4 destructive, 7 billable, 2 external).
+
+No hand-written client covers this area. Call it through `g8.api.content.*` 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: [content.d.ts](content.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addContentGridRow`](#op-addcontentgridrow) | `POST /api/v1/content/grids/{grid_id}/rows` | write | `campaigns:write` | Add Content Grid Row |
+| [`backfillContentPages`](#op-backfillcontentpages) | `POST /api/v1/content/pages/backfill` | write | `campaigns:write` | Backfill Content Pages |
+| [`createContentApprovalShare`](#op-createcontentapprovalshare) | `POST /api/v1/content/calendar/approvals` | write | `campaigns:write` | Create Content Approval Share |
+| [`createContentFromIdea`](#op-createcontentfromidea) | `POST /api/v1/content/calendar/ideas/{idea_id}/create-content` | billable | `campaigns:run` | Create Content From Idea |
+| [`createContentGrid`](#op-createcontentgrid) | `POST /api/v1/content/grids` | write | `campaigns:write` | Create Content Grid |
+| [`createContentPage`](#op-createcontentpage) | `POST /api/v1/content/pages` | write | `campaigns:write` | Create Content Page |
+| [`deleteContentGrid`](#op-deletecontentgrid) | `DELETE /api/v1/content/grids/{grid_id}` | destructive | `campaigns:delete` | Delete Content Grid |
+| [`deleteContentGridRow`](#op-deletecontentgridrow) | `DELETE /api/v1/content/grids/{grid_id}/rows/{row_id}` | destructive | `campaigns:delete` | Delete Content Grid Row |
+| [`deleteContentPage`](#op-deletecontentpage) | `DELETE /api/v1/content/pages/{page_id}` | destructive | `campaigns:delete` | Delete Content Page |
+| [`deleteContentWorkspacePage`](#op-deletecontentworkspacepage) | `DELETE /api/v1/content-workspace/pages/{page_id}` | destructive | `campaigns:delete` | Delete Content Workspace Page |
+| [`enrichContentPage`](#op-enrichcontentpage) | `POST /api/v1/content/pages/{page_id}/enrich-seo` | billable | `campaigns:run` | Enrich Content Page |
+| [`enrichContentPagesBulk`](#op-enrichcontentpagesbulk) | `POST /api/v1/content/pages/enrich-seo-bulk` | billable | `campaigns:run` | Enrich Content Pages Bulk |
+| [`getContentBackfillStatus`](#op-getcontentbackfillstatus) | `GET /api/v1/content/pages/backfill/status/{task_id}` | read | `campaigns:read` | Get Content Backfill Status |
+| [`getContentCalendar`](#op-getcontentcalendar) | `GET /api/v1/content/calendar` | read | `campaigns:read` | Get Content Calendar |
+| [`getContentGrid`](#op-getcontentgrid) | `GET /api/v1/content/grids/{grid_id}` | read | `campaigns:read` | Get Content Grid |
+| [`getContentIdeaEvidence`](#op-getcontentideaevidence) | `GET /api/v1/content/calendar/ideas/{idea_id}/evidence` | read | `campaigns:read` | Get Content Idea Evidence |
+| [`getContentImportStatus`](#op-getcontentimportstatus) | `GET /api/v1/content-workspace/import/status/{job_id}` | read | `campaigns:read` | Get Content Import Status |
+| [`getContentPage`](#op-getcontentpage) | `GET /api/v1/content/pages/{page_id}` | read | `campaigns:read` | Get Content Page |
+| [`getContentSeoSummary`](#op-getcontentseosummary) | `GET /api/v1/content-workspace/seo-summary` | read | `campaigns:read` | Get Content Seo Summary |
+| [`getContentSignalMiningStatus`](#op-getcontentsignalminingstatus) | `GET /api/v1/content/calendar/mine-signals/status` | read | `campaigns:read` | Get Content Signal Mining Status |
+| [`getContentWorkspacePage`](#op-getcontentworkspacepage) | `GET /api/v1/content-workspace/pages/{page_id}` | read | `campaigns:read` | Get Content Workspace Page |
+| [`getIdeaCorpusStats`](#op-getideacorpusstats) | `GET /api/v1/content/calendar/ideas/corpus-stats` | read | `campaigns:read` | Get Idea Corpus Stats |
+| [`importContentPagesFromSitemap`](#op-importcontentpagesfromsitemap) | `POST /api/v1/content/pages/import-sitemap` | write | `campaigns:write` | Import Content Pages From Sitemap |
+| [`listContentApprovalShares`](#op-listcontentapprovalshares) | `GET /api/v1/content/calendar/approvals` | read | `campaigns:read` | List Content Approval Shares |
+| [`listContentGrids`](#op-listcontentgrids) | `GET /api/v1/content/grids` | read | `campaigns:read` | List Content Grids |
+| [`listContentIdeas`](#op-listcontentideas) | `GET /api/v1/content/calendar/ideas` | read | `campaigns:read` | List Content Ideas |
+| [`listContentImportJobs`](#op-listcontentimportjobs) | `GET /api/v1/content-workspace/import/jobs` | read | `campaigns:read` | List Content Import Jobs |
+| [`listContentPages`](#op-listcontentpages) | `GET /api/v1/content/pages` | read | `campaigns:read` | List Content Pages |
+| [`listContentTypes`](#op-listcontenttypes) | `GET /api/v1/content/types` | read | `campaigns:read` | List Content Types |
+| [`listContentWorkspacePages`](#op-listcontentworkspacepages) | `GET /api/v1/content-workspace/pages` | read | `campaigns:read` | List Content Workspace Pages |
+| [`listWebsiteTemplates`](#op-listwebsitetemplates) | `GET /api/v1/content/website-templates` | read | `campaigns:read` | List Website Templates |
+| [`mineContentSignals`](#op-minecontentsignals) | `POST /api/v1/content/calendar/mine-signals` | billable | `campaigns:run` | Mine Content Signals |
+| [`patchContentIdea`](#op-patchcontentidea) | `PATCH /api/v1/content/calendar/ideas/{idea_id}` | write | `campaigns:write` | Patch Content Idea |
+| [`repurposeContentToAd`](#op-repurposecontenttoad) | `POST /api/v1/content/calendar/repurpose/ad` | billable | `campaigns:run` | Repurpose Content To Ad |
+| [`repurposeContentToLinkedinPost`](#op-repurposecontenttolinkedinpost) | `POST /api/v1/content/calendar/repurpose/linkedin-post` | billable | `campaigns:run` | Repurpose Content To Linkedin Post |
+| [`retryContentPublish`](#op-retrycontentpublish) | `POST /api/v1/content/calendar/{content_type}/{content_id}/retry-publish` | external | `campaigns:run` | Retry Content Publish |
+| [`scheduleContentPiece`](#op-schedulecontentpiece) | `PATCH /api/v1/content/calendar/{content_type}/{content_id}/schedule` | external | `campaigns:run` | Schedule Content Piece |
+| [`startContentCrawlImport`](#op-startcontentcrawlimport) | `POST /api/v1/content-workspace/import/crawl` | billable | `campaigns:run` | Start Content Crawl Import |
+| [`startContentSitemapImport`](#op-startcontentsitemapimport) | `POST /api/v1/content-workspace/import/sitemap` | write | `campaigns:write` | Start Content Sitemap Import |
+| [`updateContentPage`](#op-updatecontentpage) | `PATCH /api/v1/content/pages/{page_id}` | write | `campaigns:write` | Update Content Page |
+| [`updateContentWorkspacePage`](#op-updatecontentworkspacepage) | `PATCH /api/v1/content-workspace/pages/{page_id}` | write | `campaigns:write` | Update Content Workspace Page |
+
+---
+
+<a id="op-addcontentgridrow"></a>
+
+### `g8.api.content.addContentGridRow(input)`
+
+**Add Content Grid Row**
+
+- HTTP: `POST /api/v1/content/grids/{grid_id}/rows`
+- operationId: `add_content_grid_row_content_grids__grid_id__rows_post` (also callable as `g8.api.call("add_content_grid_row_content_grids__grid_id__rows_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Add one job to a grid. FREE - queuing it is not running it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.grid_id` | `string` | yes | Content grid id. |
+| `body` | `AddRowRequest` | yes | Request body; fields below. |
+
+Body fields (`AddRowRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.job_type` | `string` | yes |  |
+| `body.author_team_member_id` | `string \| null` | no |  |
+| `body.original_body` | `string \| null` | no |  |
+| `body.original_meta` | `string \| null` | no |  |
+| `body.original_title` | `string \| null` | no |  |
+| `body.source_url` | `string \| null` | no |  |
+| `body.target_keyword` | `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
+const result = await g8.api.content.addContentGridRow({ path: { grid_id: "id" }, body: { job_type: "example" } });
+```
+
+---
+
+<a id="op-backfillcontentpages"></a>
+
+### `g8.api.content.backfillContentPages(input?)`
+
+**Backfill Content Pages**
+
+- HTTP: `POST /api/v1/content/pages/backfill`
+- operationId: `backfill_content_pages_content_pages_backfill_post` (also callable as `g8.api.call("backfill_content_pages_content_pages_backfill_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Create inventory rows from website scrapes the org already has. FREE.
+
+Reads `cb_intelligence_data` - no site is fetched and no provider is
+called. IDEMPOTENT: a page that already exists is skipped rather than
+duplicated.
+
+**Input**: none.
+
+**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
+const result = await g8.api.content.backfillContentPages();
+```
+
+---
+
+<a id="op-createcontentapprovalshare"></a>
+
+### `g8.api.content.createContentApprovalShare(input)`
+
+**Create Content Approval Share**
+
+- HTTP: `POST /api/v1/content/calendar/approvals`
+- operationId: `create_content_approval_share_content_calendar_approvals_post` (also callable as `g8.api.call("create_content_approval_share_content_calendar_approvals_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Mint a client-approval link for a piece. FREE.
+
+The link is a BEARER URL: whoever holds it can approve or reject the piece
+with no graph8 login. That is what it is for - it goes to a client - but it
+means `expires_in_days` is the only thing bounding it, so send a short one
+rather than taking the fourteen-day default by accident.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateApprovalShareRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateApprovalShareRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.content_id` | `string` | yes |  |
+| `body.content_type` | `string` | yes |  |
+| `body.expires_in_days` | `integer` | no | default `14`, min 1, max 90 |
+
+**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
+const result = await g8.api.content.createContentApprovalShare({ body: { content_id: "id", content_type: "example" } });
+```
+
+---
+
+<a id="op-createcontentfromidea"></a>
+
+### `g8.api.content.createContentFromIdea(input)`
+
+**Create Content From Idea**
+
+- HTTP: `POST /api/v1/content/calendar/ideas/{idea_id}/create-content`
+- operationId: `create_content_from_idea_content_calendar_ideas__idea_id__create_content_post` (also callable as `g8.api.call("create_content_from_idea_content_calendar_ideas__idea_id__create_content_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Turn a mined idea into a DRAFT. SPENDS CREDIT, immediately and inline.
+
+Not queued - the generation runs during this call. `format` decides which
+generator runs and therefore what it costs; a landing page is the
+expensive one.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.idea_id` | `string` | yes | Mined idea id. |
+| `body` | `CreateFromIdeaRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateFromIdeaRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.format` | `"landing_page" \| "linkedin_post" \| "ad_creative" \| "newsletter_section"` | yes |  |
+
+**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.content.createContentFromIdea({ path: { idea_id: "id" }, body: { format: "landing_page" } });
+```
+
+---
+
+<a id="op-createcontentgrid"></a>
+
+### `g8.api.content.createContentGrid(input)`
+
+**Create Content Grid**
+
+- HTTP: `POST /api/v1/content/grids`
+- operationId: `create_content_grid_content_grids_post` (also callable as `g8.api.call("create_content_grid_content_grids_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 grid - a batch of content jobs. FREE.
+
+Creating the grid costs nothing; the jobs inside it cost when they RUN.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateGridRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateGridRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.grid_type` | `string` | yes |  |
+| `body.name` | `string` | yes |  |
+| `body.workflow_config` | `Record<string, unknown> \| 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
+const result = await g8.api.content.createContentGrid({ body: { grid_type: "example", name: "Example" } });
+```
+
+---
+
+<a id="op-createcontentpage"></a>
+
+### `g8.api.content.createContentPage(input)`
+
+**Create Content Page**
+
+- HTTP: `POST /api/v1/content/pages`
+- operationId: `create_content_page_content_pages_post` (also callable as `g8.api.call("create_content_page_content_pages_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Add one page to the inventory. FREE.
+
+`is_owned` defaults TRUE - this is the org's own page. Set it false to
+track a competitor's, which changes what the analytics surfaces count it
+towards.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreatePageRequest` | yes | Request body; fields below. |
+
+Body fields (`CreatePageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.url` | `string` | yes |  |
+| `body.content_status` | `string \| null` | no | default `"idea"` |
+| `body.content_type` | `string \| null` | no | default `"website"` |
+| `body.is_owned` | `boolean` | no | default `true` |
+| `body.title` | `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
+const result = await g8.api.content.createContentPage({ body: { url: "https://example.com" } });
+```
+
+---
+
+<a id="op-deletecontentgrid"></a>
+
+### `g8.api.content.deleteContentGrid(input)`
+
+**Delete Content Grid**
+
+- HTTP: `DELETE /api/v1/content/grids/{grid_id}`
+- operationId: `delete_content_grid_content_grids__grid_id__delete` (also callable as `g8.api.call("delete_content_grid_content_grids__grid_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a grid AND every row in it. The pages the rows referenced stay.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.grid_id` | `string` | yes | Content grid id. |
+
+**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
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.content.deleteContentGrid({ path: { grid_id: "id" } });
+```
+
+---
+
+<a id="op-deletecontentgridrow"></a>
+
+### `g8.api.content.deleteContentGridRow(input)`
+
+**Delete Content Grid Row**
+
+- HTTP: `DELETE /api/v1/content/grids/{grid_id}/rows/{row_id}`
+- operationId: `delete_content_grid_row_content_grids__grid_id__rows__row_id__delete` (also callable as `g8.api.call("delete_content_grid_row_content_grids__grid_id__rows__row_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Remove one job from a grid.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.grid_id` | `string` | yes | Content grid id. |
+| `path.row_id` | `string` | yes | Row id within the grid. |
+
+**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
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.content.deleteContentGridRow({ path: { grid_id: "id", row_id: "id" } });
+```
+
+---
+
+<a id="op-deletecontentpage"></a>
+
+### `g8.api.content.deleteContentPage(input)`
+
+**Delete Content Page**
+
+- HTTP: `DELETE /api/v1/content/pages/{page_id}`
+- operationId: `delete_content_page_content_pages__page_id__delete` (also callable as `g8.api.call("delete_content_page_content_pages__page_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Remove a page from the inventory.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id. |
+| `query.force` | `boolean` | no | Delete even when the page is referenced by grid rows or calendar entries. Without it, a referenced page is refused rather than silently orphaning them. 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
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.content.deleteContentPage({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-deletecontentworkspacepage"></a>
+
+### `g8.api.content.deleteContentWorkspacePage(input)`
+
+**Delete Content Workspace Page**
+
+- HTTP: `DELETE /api/v1/content-workspace/pages/{page_id}`
+- operationId: `delete_content_workspace_page_content_workspace_pages__page_id__delete` (also callable as `g8.api.call("delete_content_workspace_page_content_workspace_pages__page_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `campaigns:delete`
+
+Delete a page from the workspace. The live website is not touched.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id (UUID). |
+
+**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
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.content.deleteContentWorkspacePage({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-enrichcontentpage"></a>
+
+### `g8.api.content.enrichContentPage(input)`
+
+**Enrich Content Page**
+
+- HTTP: `POST /api/v1/content/pages/{page_id}/enrich-seo`
+- operationId: `enrich_content_page_content_pages__page_id__enrich_seo_post` (also callable as `g8.api.call("enrich_content_page_content_pages__page_id__enrich_seo_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Buy SEO data for ONE page. SPENDS PROVIDER CREDIT.
+
+The bounded version of the bulk route - one page, one charge.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id. |
+
+**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.content.enrichContentPage({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-enrichcontentpagesbulk"></a>
+
+### `g8.api.content.enrichContentPagesBulk(input)`
+
+**Enrich Content Pages Bulk**
+
+- HTTP: `POST /api/v1/content/pages/enrich-seo-bulk`
+- operationId: `enrich_content_pages_bulk_content_pages_enrich_seo_bulk_post` (also callable as `g8.api.call("enrich_content_pages_bulk_content_pages_enrich_seo_bulk_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Buy SEO data for many pages at once. SPENDS PROVIDER CREDIT, per page.
+
+`limit` is THE CEILING ON THE SPEND, not a page size - omit `page_ids` and
+this enriches the next `limit` un-enriched pages and bills for each of
+them. Send it deliberately.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `EnrichSeoBulkRequest` | yes | Request body; fields below. |
+
+Body fields (`EnrichSeoBulkRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.limit` | `integer` | no | Maximum pages enriched, and therefore the maximum spend. default `50` |
+| `body.page_ids` | `Array<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.content.enrichContentPagesBulk({ body: {} });
+```
+
+---
+
+<a id="op-getcontentbackfillstatus"></a>
+
+### `g8.api.content.getContentBackfillStatus(input)`
+
+**Get Content Backfill Status**
+
+- HTTP: `GET /api/v1/content/pages/backfill/status/{task_id}`
+- operationId: `get_content_backfill_status_content_pages_backfill_status__task_id__get` (also callable as `g8.api.call("get_content_backfill_status_content_pages_backfill_status__task_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Progress of a background content backfill. FREE - the poll target.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.task_id` | `string` | yes | Task id returned by `POST /content/pages/backfill`. |
+
+**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
+const result = await g8.api.content.getContentBackfillStatus({ path: { task_id: "id" } });
+```
+
+---
+
+<a id="op-getcontentcalendar"></a>
+
+### `g8.api.content.getContentCalendar(input)`
+
+**Get Content Calendar**
+
+- HTTP: `GET /api/v1/content/calendar`
+- operationId: `get_content_calendar_content_calendar_get` (also callable as `g8.api.call("get_content_calendar_content_calendar_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Everything scheduled in a date window, across all five lanes. FREE.
+
+Also embeds the non-archived mined ideas, so this one call answers both
+"what is shipping" and "what could we ship".
+
+`task_scope` is resolved from the key's own credential, not from a browser
+session - a key narrowed away from tasks sees the calendar without the
+review tasks attached to it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.date_from` | `string (date-time)` | yes | Window start, inclusive. |
+| `query.date_to` | `string (date-time)` | yes | Window end, inclusive. |
+| `query.types` | `string \| null` | no | Comma-separated lanes to include. Omit for all five. Same vocabulary as the `content_type` path parameter. |
+| `query.include_unscheduled` | `boolean` | no | Include pieces with no planned date, capped per lane. default `true` |
+
+**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
+const result = await g8.api.content.getContentCalendar({
+  query: { date_from: "2026-01-01T09:00:00Z", date_to: "2026-01-01T09:00:00Z" },
+});
+```
+
+---
+
+<a id="op-getcontentgrid"></a>
+
+### `g8.api.content.getContentGrid(input)`
+
+**Get Content Grid**
+
+- HTTP: `GET /api/v1/content/grids/{grid_id}`
+- operationId: `get_content_grid_content_grids__grid_id__get` (also callable as `g8.api.call("get_content_grid_content_grids__grid_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One grid with all its rows and columns. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.grid_id` | `string` | yes | Content grid id. |
+
+**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
+const result = await g8.api.content.getContentGrid({ path: { grid_id: "id" } });
+```
+
+---
+
+<a id="op-getcontentideaevidence"></a>
+
+### `g8.api.content.getContentIdeaEvidence(input)`
+
+**Get Content Idea Evidence**
+
+- HTTP: `GET /api/v1/content/calendar/ideas/{idea_id}/evidence`
+- operationId: `get_content_idea_evidence_content_calendar_ideas__idea_id__evidence_get` (also callable as `g8.api.call("get_content_idea_evidence_content_calendar_ideas__idea_id__evidence_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every conversation the idea was mined from. FREE.
+
+The provenance trail - this is how a human checks that a mined idea is
+real before spending a generation on it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.idea_id` | `string` | yes | Mined idea id. |
+
+**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.content.getContentIdeaEvidence({ path: { idea_id: "id" } });
+```
+
+---
+
+<a id="op-getcontentimportstatus"></a>
+
+### `g8.api.content.getContentImportStatus(input)`
+
+**Get Content Import Status**
+
+- HTTP: `GET /api/v1/content-workspace/import/status/{job_id}`
+- operationId: `get_content_import_status_content_workspace_import_status__job_id__get` (also callable as `g8.api.call("get_content_import_status_content_workspace_import_status__job_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One import job's progress: found, scraped, imported, skipped, failed. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.job_id` | `string` | yes | Import job id (UUID). |
+
+**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
+const result = await g8.api.content.getContentImportStatus({ path: { job_id: "id" } });
+```
+
+---
+
+<a id="op-getcontentpage"></a>
+
+### `g8.api.content.getContentPage(input)`
+
+**Get Content Page**
+
+- HTTP: `GET /api/v1/content/pages/{page_id}`
+- operationId: `get_content_page_content_pages__page_id__get` (also callable as `g8.api.call("get_content_page_content_pages__page_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One page, including its stored raw HTML. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id. |
+
+**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
+const result = await g8.api.content.getContentPage({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-getcontentseosummary"></a>
+
+### `g8.api.content.getContentSeoSummary(input?)`
+
+**Get Content Seo Summary**
+
+- HTTP: `GET /api/v1/content-workspace/seo-summary`
+- operationId: `get_content_seo_summary_content_workspace_seo_summary_get` (also callable as `g8.api.call("get_content_seo_summary_content_workspace_seo_summary_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Aggregate SEO health: issues by type and severity, average score, score bands. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.domain` | `string \| null` | no | One owned domain. Omit for all owned pages. |
+
+**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
+const result = await g8.api.content.getContentSeoSummary();
+```
+
+---
+
+<a id="op-getcontentsignalminingstatus"></a>
+
+### `g8.api.content.getContentSignalMiningStatus(input?)`
+
+**Get Content Signal Mining Status**
+
+- HTTP: `GET /api/v1/content/calendar/mine-signals/status`
+- operationId: `get_content_signal_mining_status_content_calendar_mine_signals_status_get` (also callable as `g8.api.call("get_content_signal_mining_status_content_calendar_mine_signals_status_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Progress of the org's signal-mining run. FREE - the poll target for `/mine-signals`.
+
+**Input**: none.
+
+**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
+const result = await g8.api.content.getContentSignalMiningStatus();
+```
+
+---
+
+<a id="op-getcontentworkspacepage"></a>
+
+### `g8.api.content.getContentWorkspacePage(input)`
+
+**Get Content Workspace Page**
+
+- HTTP: `GET /api/v1/content-workspace/pages/{page_id}`
+- operationId: `get_content_workspace_page_content_workspace_pages__page_id__get` (also callable as `g8.api.call("get_content_workspace_page_content_workspace_pages__page_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+One page with its SEO analysis and planning fields. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id (UUID). |
+
+**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
+const result = await g8.api.content.getContentWorkspacePage({ path: { page_id: "id" } });
+```
+
+---
+
+<a id="op-getideacorpusstats"></a>
+
+### `g8.api.content.getIdeaCorpusStats(input?)`
+
+**Get Idea Corpus Stats**
+
+- HTTP: `GET /api/v1/content/calendar/ideas/corpus-stats`
+- operationId: `get_idea_corpus_stats_content_calendar_ideas_corpus_stats_get` (also callable as `g8.api.call("get_idea_corpus_stats_content_calendar_ideas_corpus_stats_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+How many conversations each mining lookback tier covers. FREE.
+
+Call this BEFORE `/mine-signals`: the mining cost scales with the corpus,
+and this is the only way to know how big 30, 60 or 90 days actually is for
+this org before paying for it.
+
+**Input**: none.
+
+**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
+const result = await g8.api.content.getIdeaCorpusStats();
+```
+
+---
+
+<a id="op-importcontentpagesfromsitemap"></a>
+
+### `g8.api.content.importContentPagesFromSitemap(input)`
+
+**Import Content Pages From Sitemap**
+
+- HTTP: `POST /api/v1/content/pages/import-sitemap`
+- operationId: `import_content_pages_from_sitemap_content_pages_import_sitemap_post` (also callable as `g8.api.call("import_content_pages_from_sitemap_content_pages_import_sitemap_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Bulk-add pages from a sitemap URL. FREE - no provider is called.
+
+It fetches the sitemap server-side, so it must be publicly reachable. The
+two filters are substring matches over each discovered URL; without them a
+large sitemap inserts every page it lists.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ImportSitemapRequest` | yes | Request body; fields below. |
+
+Body fields (`ImportSitemapRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.sitemap_url` | `string` | yes |  |
+| `body.url_must_contain` | `Array<string> \| null` | no |  |
+| `body.url_must_not_contain` | `Array<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
+const result = await g8.api.content.importContentPagesFromSitemap({ body: { sitemap_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-listcontentapprovalshares"></a>
+
+### `g8.api.content.listContentApprovalShares(input?)`
+
+**List Content Approval Shares**
+
+- HTTP: `GET /api/v1/content/calendar/approvals`
+- operationId: `list_content_approval_shares_content_calendar_approvals_get` (also callable as `g8.api.call("list_content_approval_shares_content_calendar_approvals_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The approval links shared for review, with each one's decision. 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.content.listContentApprovalShares();
+```
+
+---
+
+<a id="op-listcontentgrids"></a>
+
+### `g8.api.content.listContentGrids(input?)`
+
+**List Content Grids**
+
+- HTTP: `GET /api/v1/content/grids`
+- operationId: `list_content_grids_content_grids_get` (also callable as `g8.api.call("list_content_grids_content_grids_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's content grids. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.grid_type` | `string \| null` | no | Filter to one grid type. |
+
+**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.content.listContentGrids();
+```
+
+---
+
+<a id="op-listcontentideas"></a>
+
+### `g8.api.content.listContentIdeas(input?)`
+
+**List Content Ideas**
+
+- HTTP: `GET /api/v1/content/calendar/ideas`
+- operationId: `list_content_ideas_content_calendar_ideas_get` (also callable as `g8.api.call("list_content_ideas_content_calendar_ideas_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The content idea pool mined from the org's own conversations. FREE.
+
+Each idea's evidence is at `GET /content/calendar/ideas/{idea_id}/evidence`;
+`POST .../create-content` turns one into a draft.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.archived` | `boolean` | no | List archived ideas instead of the active pool. default `false` |
+
+**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.content.listContentIdeas();
+```
+
+---
+
+<a id="op-listcontentimportjobs"></a>
+
+### `g8.api.content.listContentImportJobs(input?)`
+
+**List Content Import Jobs**
+
+- HTTP: `GET /api/v1/content-workspace/import/jobs`
+- operationId: `list_content_import_jobs_content_workspace_import_jobs_get` (also callable as `g8.api.call("list_content_import_jobs_content_workspace_import_jobs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The org's recent import jobs, newest first. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.status` | `string \| null` | no | Only jobs in this status. |
+| `query.limit` | `integer` | no | default `20` |
+
+**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.content.listContentImportJobs();
+```
+
+---
+
+<a id="op-listcontentpages"></a>
+
+### `g8.api.content.listContentPages(input?)`
+
+**List Content Pages**
+
+- HTTP: `GET /api/v1/content/pages`
+- operationId: `list_content_pages_content_pages_get` (also callable as `g8.api.call("list_content_pages_content_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The content inventory. FREE.
+
+Both the org's OWN pages and competitor pages it tracks - `is_owned` is
+the filter that separates them, and omitting it returns both.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.domain` | `string \| null` | no | Only pages on this domain. |
+| `query.is_owned` | `boolean \| null` | no | True for the org's own pages, false for tracked competitors'. |
+| `query.crawl_status` | `string \| null` | no |  |
+| `query.source` | `string \| null` | no |  |
+| `query.content_type` | `string \| null` | no | From `GET /content/types`. |
+| `query.content_status` | `string \| null` | no |  |
+| `query.limit` | `integer` | no | default `50` |
+| `query.offset` | `integer` | no | default `0` |
+
+**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.content.listContentPages();
+```
+
+---
+
+<a id="op-listcontenttypes"></a>
+
+### `g8.api.content.listContentTypes(input?)`
+
+**List Content Types**
+
+- HTTP: `GET /api/v1/content/types`
+- operationId: `list_content_types_content_types_get` (also callable as `g8.api.call("list_content_types_content_types_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Every content type with its per-status counts. FREE.
+
+The SOURCE of the `content_type` and `content_status` values the page
+routes filter and write on.
+
+**Input**: none.
+
+**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
+const result = await g8.api.content.listContentTypes();
+```
+
+---
+
+<a id="op-listcontentworkspacepages"></a>
+
+### `g8.api.content.listContentWorkspacePages(input?)`
+
+**List Content Workspace Pages**
+
+- HTTP: `GET /api/v1/content-workspace/pages`
+- operationId: `list_content_workspace_pages_content_workspace_pages_get` (also callable as `g8.api.call("list_content_workspace_pages_content_workspace_pages_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+The workspace's pages, filtered and paged. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.domain` | `string \| null` | no |  |
+| `query.refresh_status` | `string \| null` | no |  |
+| `query.intent` | `string \| null` | no |  |
+| `query.page_type` | `string \| null` | no |  |
+| `query.llm_cited` | `boolean \| null` | no | Only pages AI answer engines cite (or do not). |
+| `query.ai_overview_present` | `boolean \| null` | no |  |
+| `query.import_job_id` | `string \| null` | no | Only pages one import brought in. |
+| `query.search` | `string \| null` | no |  |
+| `query.page` | `integer` | no | default `1` |
+| `query.page_size` | `integer` | no | default `50` |
+| `query.sort_by` | `string` | no | Field to sort by. default `"priority_score"` |
+| `query.sort_order` | `string` | no | default `"desc"` |
+
+**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.content.listContentWorkspacePages();
+```
+
+---
+
+<a id="op-listwebsitetemplates"></a>
+
+### `g8.api.content.listWebsiteTemplates(input?)`
+
+**List Website Templates**
+
+- HTTP: `GET /api/v1/content/website-templates`
+- operationId: `list_website_templates_content_website_templates_get` (also callable as `g8.api.call("list_website_templates_content_website_templates_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `campaigns:read`
+
+Owned pages reusable as website templates. FREE.
+
+A filtered view of the inventory, not a separate store: every row here is
+also a content page.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.limit` | `integer` | no | default `24` |
+
+**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.content.listWebsiteTemplates();
+```
+
+---
+
+<a id="op-minecontentsignals"></a>
+
+### `g8.api.content.mineContentSignals(input)`
+
+**Mine Content Signals**
+
+- HTTP: `POST /api/v1/content/calendar/mine-signals`
+- operationId: `mine_content_signals_content_calendar_mine_signals_post` (also callable as `g8.api.call("mine_content_signals_content_calendar_mine_signals_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Mine meeting transcripts and inbox threads for content ideas. SPENDS CREDIT.
+
+The cost scales with `lookback_days` and the corpus it selects - check
+`/ideas/corpus-stats` first, which is free.
+
+Asynchronous: it returns once the work is dispatched. `include_archived`
+TRUE (the app's default) lets a previously dismissed theme resurface.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `MineSignalsRequest` | yes | Request body; fields below. |
+
+Body fields (`MineSignalsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.focus` | `string \| null` | no | max length 300 |
+| `body.include_archived` | `boolean` | no | default `true` |
+| `body.lookback_days` | `integer` | no | default `60`, min 1, max 365 |
+| `body.max_ideas` | `integer` | no | default `5`, min 1, max 20 |
+| `body.sources` | `Array<"meetings" \| "emails">` | no | Which corpora to mine. Closed to the two the app accepts - it rejects anything else, and an unknown value would otherwise mine an empty corpus at full price. |
+| `body.target_format` | `"landing_page" \| "linkedin_post" \| "newsletter_section" \| "ad_creative" \| 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.content.mineContentSignals({ body: {} });
+```
+
+---
+
+<a id="op-patchcontentidea"></a>
+
+### `g8.api.content.patchContentIdea(input)`
+
+**Patch Content Idea**
+
+- HTTP: `PATCH /api/v1/content/calendar/ideas/{idea_id}`
+- operationId: `patch_content_idea_content_calendar_ideas__idea_id__patch` (also callable as `g8.api.call("patch_content_idea_content_calendar_ideas__idea_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Bookmark, rate or date a mined idea. FREE.
+
+PARTIAL: an ABSENT field is untouched, a field sent as NULL is CLEARED.
+Those are different instructions and only the second one erases - which is
+why the proxy forwards `exclude_unset` rather than a full dump.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.idea_id` | `string` | yes | Mined idea id. |
+| `body` | `PatchIdeaRequest` | yes | Request body; fields below. |
+
+Body fields (`PatchIdeaRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.rating` | `integer \| null` | no |  |
+| `body.scheduled_for` | `string \| null` | no |  |
+| `body.status` | `"new" \| "saved" \| 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
+const result = await g8.api.content.patchContentIdea({ path: { idea_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-repurposecontenttoad"></a>
+
+### `g8.api.content.repurposeContentToAd(input)`
+
+**Repurpose Content To Ad**
+
+- HTTP: `POST /api/v1/content/calendar/repurpose/ad`
+- operationId: `repurpose_content_to_ad_content_calendar_repurpose_ad_post` (also callable as `g8.api.call("repurpose_content_to_ad_content_calendar_repurpose_ad_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Derive an ad creative from an existing piece. SPENDS CREDIT.
+
+`ads:create`, matching the app - it produces the same object
+`POST /ad-creatives` does, so it carries the same grant rather than riding
+along on a calendar permission.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `RepurposeAdRequest` | yes | Request body; fields below. |
+
+Body fields (`RepurposeAdRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.source_id` | `string` | yes |  |
+| `body.source_type` | `string` | yes |  |
+| `body.ad_format` | `string` | no | default `"single_image"` |
+| `body.platform` | `string` | no | default `"linkedin"` |
+
+**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.content.repurposeContentToAd({ body: { source_id: "id", source_type: "example" } });
+```
+
+---
+
+<a id="op-repurposecontenttolinkedinpost"></a>
+
+### `g8.api.content.repurposeContentToLinkedinPost(input)`
+
+**Repurpose Content To Linkedin Post**
+
+- HTTP: `POST /api/v1/content/calendar/repurpose/linkedin-post`
+- operationId: `repurpose_content_to_linkedin_post_content_calendar_repurpose_linkedin_post_post` (also callable as `g8.api.call("repurpose_content_to_linkedin_post_content_calendar_repurpose_linkedin_post_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Derive a LinkedIn post DRAFT from an existing piece. SPENDS CREDIT.
+
+A draft: nothing is posted. It lands in the `linkedin_post` lane and a
+review task is raised against it. Publishing is
+`POST /social/posts/{id}/publish`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `RepurposeSourceRequest` | yes | Request body; fields below. |
+
+Body fields (`RepurposeSourceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.source_id` | `string` | yes |  |
+| `body.source_type` | `string` | yes |  |
+
+**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.content.repurposeContentToLinkedinPost({ body: { source_id: "id", source_type: "example" } });
+```
+
+---
+
+<a id="op-retrycontentpublish"></a>
+
+### `g8.api.content.retryContentPublish(input)`
+
+**Retry Content Publish**
+
+- HTTP: `POST /api/v1/content/calendar/{content_type}/{content_id}/retry-publish`
+- operationId: `retry_content_publish_content_calendar__content_type___content_id__retry_publish_post` (also callable as `g8.api.call("retry_content_publish_content_calendar__content_type___content_id__retry_publish_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `campaigns:run`
+
+Re-arm a failed scheduled publish. IT WILL GO OUT ON THE NEXT SWEEP.
+
+Moves the entry from `failed` back to `scheduled`, which means the same
+piece is published to real people the next time the sweep runs. Same
+launch permission and the same tier as arming it in the first place -
+"retry" is not a smaller act than "publish", it is the same one.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.content_type` | `"newsletter_issue" \| "landing_page" \| "seo_page" \| "linkedin_post" \| "ad_creative"` | yes | Which content lane the piece lives in. |
+| `path.content_id` | `string` | yes | Id of the piece within that lane. |
+
+**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
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.content.retryContentPublish({ path: { content_type: "newsletter_issue", content_id: "id" } });
+```
+
+---
+
+<a id="op-schedulecontentpiece"></a>
+
+### `g8.api.content.scheduleContentPiece(input)`
+
+**Schedule Content Piece**
+
+- HTTP: `PATCH /api/v1/content/calendar/{content_type}/{content_id}/schedule`
+- operationId: `schedule_content_piece_content_calendar__content_type___content_id__schedule_patch` (also callable as `g8.api.call("schedule_content_piece_content_calendar__content_type___content_id__schedule_patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `campaigns:run`
+
+Plan a piece's date and owner - or ARM it to publish itself.
+
+`arm: false` (the default) records a date for a human to act on and
+changes nothing outward-facing.
+
+`arm: true` IS THE OUTWARD-FACING ONE: the publish sweep will send or
+deploy the piece at `planned_publish_at`, to real people, with no further
+confirmation. The app requires `campaigns:launch` for that branch
+specifically, and the principal this proxy hands it is resolved from the
+validated key so that check answers correctly rather than silently.
+
+`linkedin_post` REFUSES a date here - LinkedIn schedules belong to
+`POST /social/posts/{id}/schedule`. Owner assignment on a LinkedIn post is
+still accepted.
+
+Spends nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.content_type` | `"newsletter_issue" \| "landing_page" \| "seo_page" \| "linkedin_post" \| "ad_creative"` | yes | Which content lane the piece lives in. |
+| `path.content_id` | `string` | yes | Id of the piece within that lane. |
+| `body` | `ScheduleRequest` | yes | Request body; fields below. |
+
+Body fields (`ScheduleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.arm` | `boolean` | no | TRUE MEANS IT WILL PUBLISH ITSELF at planned_publish_at, with no further human step. False only records the date. default `false` |
+| `body.clear_planned` | `boolean` | no | default `false` |
+| `body.owner_id` | `string \| null` | no |  |
+| `body.planned_publish_at` | `string (date-time) \| null` | no |  |
+| `body.publish_settings` | `Record<string, unknown> \| 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
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.content.scheduleContentPiece({
+  path: { content_type: "newsletter_issue", content_id: "id" },
+  body: {},
+});
+```
+
+---
+
+<a id="op-startcontentcrawlimport"></a>
+
+### `g8.api.content.startContentCrawlImport(input)`
+
+**Start Content Crawl Import**
+
+- HTTP: `POST /api/v1/content-workspace/import/crawl`
+- operationId: `start_content_crawl_import_content_workspace_import_crawl_post` (also callable as `g8.api.call("start_content_crawl_import_content_workspace_import_crawl_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `campaigns:run`
+
+Deep-crawl the org's own website into the workspace. SPENDS PROVIDER CREDIT.
+
+Billed per page crawled; `max_pages` is the ceiling on the spend. Only the
+org's registered website can be crawled. Returns the import job - poll
+`GET /content-workspace/import/status/{job_id}`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ContentWorkspaceCrawlRequest` | yes | Request body; fields below. |
+
+Body fields (`ContentWorkspaceCrawlRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.start_url` | `string` | yes | Must be on the org's registered website. |
+| `body.exclude_paths` | `Array<string> \| null` | no | e.g. ['/author', '/tag']. |
+| `body.include_paths` | `Array<string> \| null` | no | e.g. ['/blog', '/resources']. |
+| `body.max_pages` | `integer` | no | The ceiling on pages crawled - and on the spend. default `500`, min 1, max 5000 |
+
+**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.content.startContentCrawlImport({ body: { start_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-startcontentsitemapimport"></a>
+
+### `g8.api.content.startContentSitemapImport(input)`
+
+**Start Content Sitemap Import**
+
+- HTTP: `POST /api/v1/content-workspace/import/sitemap`
+- operationId: `start_content_sitemap_import_content_workspace_import_sitemap_post` (also callable as `g8.api.call("start_content_sitemap_import_content_workspace_import_sitemap_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Import the pages an XML sitemap lists. FREE. Returns the import job to poll.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ContentWorkspaceSitemapImportRequest` | yes | Request body; fields below. |
+
+Body fields (`ContentWorkspaceSitemapImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.sitemap_url` | `string` | yes |  |
+| `body.exclude_patterns` | `Array<string> \| null` | no | Glob patterns to exclude. |
+| `body.include_patterns` | `Array<string> \| null` | no | Glob patterns to include. |
+| `body.max_pages` | `integer` | no | default `500`, min 1, max 5000 |
+
+**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
+const result = await g8.api.content.startContentSitemapImport({ body: { sitemap_url: "https://example.com" } });
+```
+
+---
+
+<a id="op-updatecontentpage"></a>
+
+### `g8.api.content.updateContentPage(input)`
+
+**Update Content Page**
+
+- HTTP: `PATCH /api/v1/content/pages/{page_id}`
+- operationId: `update_content_page_content_pages__page_id__patch` (also callable as `g8.api.call("update_content_page_content_pages__page_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Edit a page's metadata or body. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id. |
+| `body` | `UpdatePageRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdatePageRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.body_content` | `string \| null` | no |  |
+| `body.content_status` | `string \| null` | no |  |
+| `body.content_type` | `string \| null` | no |  |
+| `body.primary_keyword` | `string \| null` | no |  |
+| `body.title` | `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
+const result = await g8.api.content.updateContentPage({ path: { page_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updatecontentworkspacepage"></a>
+
+### `g8.api.content.updateContentWorkspacePage(input)`
+
+**Update Content Workspace Page**
+
+- HTTP: `PATCH /api/v1/content-workspace/pages/{page_id}`
+- operationId: `update_content_workspace_page_content_workspace_pages__page_id__patch` (also callable as `g8.api.call("update_content_workspace_page_content_workspace_pages__page_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `campaigns:write`
+
+Update a page's refresh-planning fields. FREE. Only the fields you send change.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.page_id` | `string` | yes | Content page id (UUID). |
+| `body` | `ContentWorkspacePageUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`ContentWorkspacePageUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.intent` | `string \| null` | no |  |
+| `body.key_issues` | `string \| null` | no |  |
+| `body.owner_id` | `string \| null` | no |  |
+| `body.page_type` | `string \| null` | no |  |
+| `body.planned_changes` | `string \| null` | no |  |
+| `body.primary_keyword` | `string \| null` | no |  |
+| `body.primary_topic` | `string \| null` | no |  |
+| `body.refresh_scope` | `string \| null` | no |  |
+| `body.refresh_status` | `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
+const result = await g8.api.content.updateContentWorkspacePage({ path: { page_id: "id" }, body: {} });
+```