@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/content.d.ts

@@ -0,0 +1,968 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.content` (Content): 41 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"add_content_grid_row_content_grids__grid_id__rows_post">;
+ *
+ * Reference with examples: content.md
+ */
+/* eslint-disable */
+
+/** `g8.api.content.<member>` -> the operationId it calls. */
+export interface ContentMembers {
+  addContentGridRow: "add_content_grid_row_content_grids__grid_id__rows_post";
+  backfillContentPages: "backfill_content_pages_content_pages_backfill_post";
+  createContentApprovalShare: "create_content_approval_share_content_calendar_approvals_post";
+  createContentFromIdea: "create_content_from_idea_content_calendar_ideas__idea_id__create_content_post";
+  createContentGrid: "create_content_grid_content_grids_post";
+  createContentPage: "create_content_page_content_pages_post";
+  deleteContentGrid: "delete_content_grid_content_grids__grid_id__delete";
+  deleteContentGridRow: "delete_content_grid_row_content_grids__grid_id__rows__row_id__delete";
+  deleteContentPage: "delete_content_page_content_pages__page_id__delete";
+  deleteContentWorkspacePage: "delete_content_workspace_page_content_workspace_pages__page_id__delete";
+  enrichContentPage: "enrich_content_page_content_pages__page_id__enrich_seo_post";
+  enrichContentPagesBulk: "enrich_content_pages_bulk_content_pages_enrich_seo_bulk_post";
+  getContentBackfillStatus: "get_content_backfill_status_content_pages_backfill_status__task_id__get";
+  getContentCalendar: "get_content_calendar_content_calendar_get";
+  getContentGrid: "get_content_grid_content_grids__grid_id__get";
+  getContentIdeaEvidence: "get_content_idea_evidence_content_calendar_ideas__idea_id__evidence_get";
+  getContentImportStatus: "get_content_import_status_content_workspace_import_status__job_id__get";
+  getContentPage: "get_content_page_content_pages__page_id__get";
+  getContentSeoSummary: "get_content_seo_summary_content_workspace_seo_summary_get";
+  getContentSignalMiningStatus: "get_content_signal_mining_status_content_calendar_mine_signals_status_get";
+  getContentWorkspacePage: "get_content_workspace_page_content_workspace_pages__page_id__get";
+  getIdeaCorpusStats: "get_idea_corpus_stats_content_calendar_ideas_corpus_stats_get";
+  importContentPagesFromSitemap: "import_content_pages_from_sitemap_content_pages_import_sitemap_post";
+  listContentApprovalShares: "list_content_approval_shares_content_calendar_approvals_get";
+  listContentGrids: "list_content_grids_content_grids_get";
+  listContentIdeas: "list_content_ideas_content_calendar_ideas_get";
+  listContentImportJobs: "list_content_import_jobs_content_workspace_import_jobs_get";
+  listContentPages: "list_content_pages_content_pages_get";
+  listContentTypes: "list_content_types_content_types_get";
+  listContentWorkspacePages: "list_content_workspace_pages_content_workspace_pages_get";
+  listWebsiteTemplates: "list_website_templates_content_website_templates_get";
+  mineContentSignals: "mine_content_signals_content_calendar_mine_signals_post";
+  patchContentIdea: "patch_content_idea_content_calendar_ideas__idea_id__patch";
+  repurposeContentToAd: "repurpose_content_to_ad_content_calendar_repurpose_ad_post";
+  repurposeContentToLinkedinPost: "repurpose_content_to_linkedin_post_content_calendar_repurpose_linkedin_post_post";
+  retryContentPublish: "retry_content_publish_content_calendar__content_type___content_id__retry_publish_post";
+  scheduleContentPiece: "schedule_content_piece_content_calendar__content_type___content_id__schedule_patch";
+  startContentCrawlImport: "start_content_crawl_import_content_workspace_import_crawl_post";
+  startContentSitemapImport: "start_content_sitemap_import_content_workspace_import_sitemap_post";
+  updateContentPage: "update_content_page_content_pages__page_id__patch";
+  updateContentWorkspacePage: "update_content_workspace_page_content_workspace_pages__page_id__patch";
+}
+
+/** Input and output of every `g8.api.content` operation, keyed by operationId. */
+export interface ContentOperations {
+  /**
+   * POST /content/grids/{grid_id}/rows
+   * Add Content Grid Row
+   * tier: write · scope: campaigns:write
+   */
+  add_content_grid_row_content_grids__grid_id__rows_post: {
+    input: {
+    path: {
+      /** Content grid id. */
+      grid_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AddRowRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/pages/backfill
+   * Backfill Content Pages
+   * tier: write · scope: campaigns:write
+   */
+  backfill_content_pages_content_pages_backfill_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/calendar/approvals
+   * Create Content Approval Share
+   * tier: write · scope: campaigns:write
+   */
+  create_content_approval_share_content_calendar_approvals_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateApprovalShareRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/calendar/ideas/{idea_id}/create-content
+   * Create Content From Idea
+   * tier: billable · scope: campaigns:run
+   */
+  create_content_from_idea_content_calendar_ideas__idea_id__create_content_post: {
+    input: {
+    path: {
+      /** Mined idea id. */
+      idea_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateFromIdeaRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/grids
+   * Create Content Grid
+   * tier: write · scope: campaigns:write
+   */
+  create_content_grid_content_grids_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateGridRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/pages
+   * Create Content Page
+   * tier: write · scope: campaigns:write
+   */
+  create_content_page_content_pages_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreatePageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /content/grids/{grid_id}
+   * Delete Content Grid
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_content_grid_content_grids__grid_id__delete: {
+    input: {
+    path: {
+      /** Content grid id. */
+      grid_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /content/grids/{grid_id}/rows/{row_id}
+   * Delete Content Grid Row
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_content_grid_row_content_grids__grid_id__rows__row_id__delete: {
+    input: {
+    path: {
+      /** Content grid id. */
+      grid_id: string;
+      /** Row id within the grid. */
+      row_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /content/pages/{page_id}
+   * Delete Content Page
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_content_page_content_pages__page_id__delete: {
+    input: {
+    path: {
+      /** Content page id. */
+      page_id: string;
+    };
+    query?: {
+      /** 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. */
+      force?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /content-workspace/pages/{page_id}
+   * Delete Content Workspace Page
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_content_workspace_page_content_workspace_pages__page_id__delete: {
+    input: {
+    path: {
+      /** Content page id (UUID). */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/pages/{page_id}/enrich-seo
+   * Enrich Content Page
+   * tier: billable · scope: campaigns:run
+   */
+  enrich_content_page_content_pages__page_id__enrich_seo_post: {
+    input: {
+    path: {
+      /** Content page id. */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/pages/enrich-seo-bulk
+   * Enrich Content Pages Bulk
+   * tier: billable · scope: campaigns:run
+   */
+  enrich_content_pages_bulk_content_pages_enrich_seo_bulk_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EnrichSeoBulkRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/pages/backfill/status/{task_id}
+   * Get Content Backfill Status
+   * tier: read · scope: campaigns:read
+   */
+  get_content_backfill_status_content_pages_backfill_status__task_id__get: {
+    input: {
+    path: {
+      /** Task id returned by `POST /content/pages/backfill`. */
+      task_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/calendar
+   * Get Content Calendar
+   * tier: read · scope: campaigns:read
+   */
+  get_content_calendar_content_calendar_get: {
+    input: {
+    query: {
+      /** Window start, inclusive. */
+      date_from: string;
+      /** Window end, inclusive. */
+      date_to: string;
+      /** Comma-separated lanes to include. Omit for all five. Same vocabulary as the `content_type` path parameter. */
+      types?: string | null;
+      /** Include pieces with no planned date, capped per lane. */
+      include_unscheduled?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/grids/{grid_id}
+   * Get Content Grid
+   * tier: read · scope: campaigns:read
+   */
+  get_content_grid_content_grids__grid_id__get: {
+    input: {
+    path: {
+      /** Content grid id. */
+      grid_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/calendar/ideas/{idea_id}/evidence
+   * Get Content Idea Evidence
+   * tier: read · scope: campaigns:read
+   */
+  get_content_idea_evidence_content_calendar_ideas__idea_id__evidence_get: {
+    input: {
+    path: {
+      /** Mined idea id. */
+      idea_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content-workspace/import/status/{job_id}
+   * Get Content Import Status
+   * tier: read · scope: campaigns:read
+   */
+  get_content_import_status_content_workspace_import_status__job_id__get: {
+    input: {
+    path: {
+      /** Import job id (UUID). */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/pages/{page_id}
+   * Get Content Page
+   * tier: read · scope: campaigns:read
+   */
+  get_content_page_content_pages__page_id__get: {
+    input: {
+    path: {
+      /** Content page id. */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content-workspace/seo-summary
+   * Get Content Seo Summary
+   * tier: read · scope: campaigns:read
+   */
+  get_content_seo_summary_content_workspace_seo_summary_get: {
+    input: {
+    query?: {
+      /** One owned domain. Omit for all owned pages. */
+      domain?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/calendar/mine-signals/status
+   * Get Content Signal Mining Status
+   * tier: read · scope: campaigns:read
+   */
+  get_content_signal_mining_status_content_calendar_mine_signals_status_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content-workspace/pages/{page_id}
+   * Get Content Workspace Page
+   * tier: read · scope: campaigns:read
+   */
+  get_content_workspace_page_content_workspace_pages__page_id__get: {
+    input: {
+    path: {
+      /** Content page id (UUID). */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/calendar/ideas/corpus-stats
+   * Get Idea Corpus Stats
+   * tier: read · scope: campaigns:read
+   */
+  get_idea_corpus_stats_content_calendar_ideas_corpus_stats_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/pages/import-sitemap
+   * Import Content Pages From Sitemap
+   * tier: write · scope: campaigns:write
+   */
+  import_content_pages_from_sitemap_content_pages_import_sitemap_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ImportSitemapRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content/calendar/approvals
+   * List Content Approval Shares
+   * tier: read · scope: campaigns:read
+   */
+  list_content_approval_shares_content_calendar_approvals_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content/grids
+   * List Content Grids
+   * tier: read · scope: campaigns:read
+   */
+  list_content_grids_content_grids_get: {
+    input: {
+    query?: {
+      /** Filter to one grid type. */
+      grid_type?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content/calendar/ideas
+   * List Content Ideas
+   * tier: read · scope: campaigns:read
+   */
+  list_content_ideas_content_calendar_ideas_get: {
+    input: {
+    query?: {
+      /** List archived ideas instead of the active pool. */
+      archived?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content-workspace/import/jobs
+   * List Content Import Jobs
+   * tier: read · scope: campaigns:read
+   */
+  list_content_import_jobs_content_workspace_import_jobs_get: {
+    input: {
+    query?: {
+      /** Only jobs in this status. */
+      status?: string | null;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content/pages
+   * List Content Pages
+   * tier: read · scope: campaigns:read
+   */
+  list_content_pages_content_pages_get: {
+    input: {
+    query?: {
+      /** Only pages on this domain. */
+      domain?: string | null;
+      /** True for the org's own pages, false for tracked competitors'. */
+      is_owned?: boolean | null;
+      crawl_status?: string | null;
+      source?: string | null;
+      /** From `GET /content/types`. */
+      content_type?: string | null;
+      content_status?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content/types
+   * List Content Types
+   * tier: read · scope: campaigns:read
+   */
+  list_content_types_content_types_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /content-workspace/pages
+   * List Content Workspace Pages
+   * tier: read · scope: campaigns:read
+   */
+  list_content_workspace_pages_content_workspace_pages_get: {
+    input: {
+    query?: {
+      domain?: string | null;
+      refresh_status?: string | null;
+      intent?: string | null;
+      page_type?: string | null;
+      /** Only pages AI answer engines cite (or do not). */
+      llm_cited?: boolean | null;
+      ai_overview_present?: boolean | null;
+      /** Only pages one import brought in. */
+      import_job_id?: string | null;
+      search?: string | null;
+      page?: number;
+      page_size?: number;
+      /** Field to sort by. */
+      sort_by?: string;
+      sort_order?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /content/website-templates
+   * List Website Templates
+   * tier: read · scope: campaigns:read
+   */
+  list_website_templates_content_website_templates_get: {
+    input: {
+    query?: {
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /content/calendar/mine-signals
+   * Mine Content Signals
+   * tier: billable · scope: campaigns:run
+   */
+  mine_content_signals_content_calendar_mine_signals_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MineSignalsRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /content/calendar/ideas/{idea_id}
+   * Patch Content Idea
+   * tier: write · scope: campaigns:write
+   */
+  patch_content_idea_content_calendar_ideas__idea_id__patch: {
+    input: {
+    path: {
+      /** Mined idea id. */
+      idea_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PatchIdeaRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/calendar/repurpose/ad
+   * Repurpose Content To Ad
+   * tier: billable · scope: campaigns:run
+   */
+  repurpose_content_to_ad_content_calendar_repurpose_ad_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RepurposeAdRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/calendar/repurpose/linkedin-post
+   * Repurpose Content To Linkedin Post
+   * tier: billable · scope: campaigns:run
+   */
+  repurpose_content_to_linkedin_post_content_calendar_repurpose_linkedin_post_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RepurposeSourceRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content/calendar/{content_type}/{content_id}/retry-publish
+   * Retry Content Publish
+   * tier: external · scope: campaigns:run
+   */
+  retry_content_publish_content_calendar__content_type___content_id__retry_publish_post: {
+    input: {
+    path: {
+      /** Which content lane the piece lives in. */
+      content_type: "newsletter_issue" | "landing_page" | "seo_page" | "linkedin_post" | "ad_creative";
+      /** Id of the piece within that lane. */
+      content_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /content/calendar/{content_type}/{content_id}/schedule
+   * Schedule Content Piece
+   * tier: external · scope: campaigns:run
+   */
+  schedule_content_piece_content_calendar__content_type___content_id__schedule_patch: {
+    input: {
+    path: {
+      /** Which content lane the piece lives in. */
+      content_type: "newsletter_issue" | "landing_page" | "seo_page" | "linkedin_post" | "ad_creative";
+      /** Id of the piece within that lane. */
+      content_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ScheduleRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content-workspace/import/crawl
+   * Start Content Crawl Import
+   * tier: billable · scope: campaigns:run
+   */
+  start_content_crawl_import_content_workspace_import_crawl_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ContentWorkspaceCrawlRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /content-workspace/import/sitemap
+   * Start Content Sitemap Import
+   * tier: write · scope: campaigns:write
+   */
+  start_content_sitemap_import_content_workspace_import_sitemap_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ContentWorkspaceSitemapImportRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /content/pages/{page_id}
+   * Update Content Page
+   * tier: write · scope: campaigns:write
+   */
+  update_content_page_content_pages__page_id__patch: {
+    input: {
+    path: {
+      /** Content page id. */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdatePageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /content-workspace/pages/{page_id}
+   * Update Content Workspace Page
+   * tier: write · scope: campaigns:write
+   */
+  update_content_workspace_page_content_workspace_pages__page_id__patch: {
+    input: {
+    path: {
+      /** Content page id (UUID). */
+      page_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ContentWorkspacePageUpdateRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+}
+
+// 21 schemas referenced above (the same as G8Contract.<Name>).
+
+/** Add one job to a grid. Spends nothing until the job is run. */
+export interface AddRowRequest {
+  author_team_member_id?: string | null;
+  job_type: string;
+  original_body?: string | null;
+  original_meta?: string | null;
+  original_title?: string | null;
+  source_url?: string | null;
+  target_keyword?: string | null;
+}
+
+export interface ApiResponse_StudioContentListPayload_ {
+  data: StudioContentListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioContentPayload_ {
+  data: StudioContentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+/** Deep-crawl the org's OWN website. SPENDS PROVIDER CREDIT, per page crawled. */
+export interface ContentWorkspaceCrawlRequest {
+  /** e.g. ['/author', '/tag']. */
+  exclude_paths?: Array<string> | null;
+  /** e.g. ['/blog', '/resources']. */
+  include_paths?: Array<string> | null;
+  /** The ceiling on pages crawled - and on the spend. */
+  max_pages?: number;
+  /** Must be on the org's registered website. */
+  start_url: string;
+}
+
+/** Partial update of a page's SEO-refresh planning fields. */
+export interface ContentWorkspacePageUpdateRequest {
+  intent?: string | null;
+  key_issues?: string | null;
+  owner_id?: string | null;
+  page_type?: string | null;
+  planned_changes?: string | null;
+  primary_keyword?: string | null;
+  primary_topic?: string | null;
+  refresh_scope?: string | null;
+  refresh_status?: string | null;
+}
+
+/** Import the pages listed in an XML sitemap. */
+export interface ContentWorkspaceSitemapImportRequest {
+  /** Glob patterns to exclude. */
+  exclude_patterns?: Array<string> | null;
+  /** Glob patterns to include. */
+  include_patterns?: Array<string> | null;
+  max_pages?: number;
+  sitemap_url: string;
+}
+
+/**
+ * Mint a tokenised approval link for a piece. Spends nothing.
+ *
+ * The link is a BEARER URL: anyone holding it can approve or reject the
+ * piece without a graph8 login. That is the point - it goes to a client -
+ * but it means the expiry is the only thing bounding it.
+ */
+export interface CreateApprovalShareRequest {
+  content_id: string;
+  content_type: string;
+  expires_in_days?: number;
+}
+
+/** Turn a mined idea into a draft. SPENDS CREDIT, immediately. */
+export interface CreateFromIdeaRequest {
+  format: "landing_page" | "linkedin_post" | "ad_creative" | "newsletter_section";
+}
+
+/** Create a content grid - a batch of content jobs. Spends nothing itself. */
+export interface CreateGridRequest {
+  grid_type: string;
+  name: string;
+  workflow_config?: Record<string, unknown> | null;
+}
+
+/** Add one page to the content inventory. Spends nothing. */
+export interface CreatePageRequest {
+  content_status?: string | null;
+  content_type?: string | null;
+  is_owned?: boolean;
+  title?: string | null;
+  url: string;
+}
+
+/**
+ * Bulk SEO enrichment. SPENDS PROVIDER CREDIT, once per page.
+ *
+ * Omit `page_ids` to take the next `limit` un-enriched pages. `limit` is the
+ * ceiling on the spend, so send it deliberately rather than by default.
+ */
+export interface EnrichSeoBulkRequest {
+  /** Maximum pages enriched, and therefore the maximum spend. */
+  limit?: number;
+  page_ids?: Array<string> | null;
+}
+
+/**
+ * Import pages from a sitemap. Fetches the sitemap; spends no credit.
+ *
+ * The two filters are substring matches applied to each discovered URL.
+ */
+export interface ImportSitemapRequest {
+  sitemap_url: string;
+  url_must_contain?: Array<string> | null;
+  url_must_not_contain?: Array<string> | null;
+}
+
+/**
+ * Mine conversations for content ideas. SPENDS CREDIT, per conversation.
+ *
+ * The cost scales with `lookback_days` and the size of the corpus it
+ * selects - check `GET /content/calendar/ideas/corpus-stats` first, which is
+ * free and tells you how many conversations each lookback tier covers.
+ *
+ * `include_archived` TRUE (the app's default) lets a previously dismissed
+ * theme resurface; false is "fresh only".
+ */
+export interface MineSignalsRequest {
+  focus?: string | null;
+  include_archived?: boolean;
+  lookback_days?: number;
+  max_ideas?: number;
+  /** 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. */
+  sources?: Array<"meetings" | "emails">;
+  target_format?: ("landing_page" | "linkedin_post" | "newsletter_section" | "ad_creative") | null;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * Card actions on a mined idea. Spends nothing.
+ *
+ * PARTIAL: an absent field is untouched, a field sent as NULL is CLEARED.
+ * Those are different instructions and only the second one erases.
+ */
+export interface PatchIdeaRequest {
+  rating?: number | null;
+  scheduled_for?: string | null;
+  status?: ("new" | "saved") | null;
+}
+
+/** Derive an ad creative from an existing piece. SPENDS CREDIT. */
+export interface RepurposeAdRequest {
+  ad_format?: string;
+  platform?: string;
+  source_id: string;
+  source_type: string;
+}
+
+/** Derive a LinkedIn post from an existing piece. SPENDS CREDIT. */
+export interface RepurposeSourceRequest {
+  source_id: string;
+  source_type: string;
+}
+
+/**
+ * Place a piece on the calendar, or ARM it to publish itself.
+ *
+ * `arm` is the consequential field: false plans the date for a human, true
+ * hands it to the publish sweep, which will put the piece in front of real
+ * people at `planned_publish_at` with no further confirmation.
+ */
+export interface ScheduleRequest {
+  /** TRUE MEANS IT WILL PUBLISH ITSELF at planned_publish_at, with no further human step. False only records the date. */
+  arm?: boolean;
+  clear_planned?: boolean;
+  owner_id?: string | null;
+  planned_publish_at?: string | null;
+  publish_settings?: Record<string, unknown> | null;
+}
+
+/**
+ * A LIST result, open-shaped, with `items` always present.
+ *
+ * The app returns a bare list from some routes and a named key from others
+ * (`pages`, `grids`, `images`, `creatives`, `reports`, `items`). Both are
+ * published: the original key is preserved AND mirrored onto `items`, so a
+ * client can page any Studio collection the same way without a per-route
+ * lookup table.
+ */
+export interface StudioContentListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** One Studio object, open-shaped. See the module docstring. */
+export type StudioContentPayload = Record<string, unknown>;
+
+/** Edit an inventory page. Spends nothing. */
+export interface UpdatePageRequest {
+  body_content?: string | null;
+  content_status?: string | null;
+  content_type?: string | null;
+  primary_keyword?: string | null;
+  title?: string | null;
+}