@graph8/sdk 0.245.0 → 0.260.0

package/docs/api/signals.d.ts

@@ -0,0 +1,1441 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.signals` (Signals): 56 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"add_engagers_to_list_social_listeners_posts__post_id__engagements_add_to_list_post">;
+ *
+ * Reference with examples: signals.md
+ */
+/* eslint-disable */
+
+/** `g8.api.signals.<member>` -> the operationId it calls. */
+export interface SignalsMembers {
+  addEngagersToList: "add_engagers_to_list_social_listeners_posts__post_id__engagements_add_to_list_post";
+  addPostAuthorToSequence: "add_post_author_to_sequence_social_listeners_posts__post_id__add_to_sequence_post";
+  autoSeedAllListeners: "auto_seed_all_listeners_social_listeners_auto_seed_all_post";
+  autoSeedBrandListener: "auto_seed_brand_listener_social_listeners_auto_seed_brand_post";
+  autoSeedCompetitorListeners: "auto_seed_competitor_listeners_social_listeners_auto_seed_competitors_post";
+  autoSeedEngagementListeners: "auto_seed_engagement_listeners_social_listeners_auto_seed_engagement_post";
+  autoSeedKeywordListeners: "auto_seed_keyword_listeners_social_listeners_auto_seed_keywords_post";
+  bulkCreateListenersFromList: "bulk_create_listeners_from_list_social_listeners_bulk_from_list_post";
+  connectXCredentials: "connect_x_credentials_social_listeners_integrations_x_post";
+  createListener: "create_listener_social_listeners_post";
+  deleteKeywordUrl: "delete_keyword_url_intent_keyword_urls__url_id__delete";
+  deleteListener: "delete_listener_social_listeners__listener_id__delete";
+  disconnectXCredentials: "disconnect_x_credentials_social_listeners_integrations_x_delete";
+  generateListenerQuery: "generate_listener_query_social_listeners_queries_generate_post";
+  getAbmCompanyPersonas: "get_abm_company_personas_intent_abm_companies__company_id__personas_get";
+  getAutoSeedStatus: "get_auto_seed_status_social_listeners_auto_seed_status_get";
+  getCompanyJobCounts: "get_company_job_counts_hiring_signals_companies_job_counts_post";
+  getHiringJobDetails: "get_hiring_job_details_hiring_signals_jobs__job_id__get";
+  getJobResolutionStatus: "get_job_resolution_status_intent_keywords__keyword_id__job_resolution_get";
+  getKeywordSyncConfig: "get_keyword_sync_config_intent_keywords__keyword_id__sync_config_get";
+  getListener: "get_listener_social_listeners__listener_id__get";
+  getSocialSettings: "get_social_settings_social_listeners_settings_get";
+  getSocialStats: "get_social_stats_social_listeners_stats_get";
+  getXEffectiveMode: "get_x_effective_mode_social_listeners_integrations_x_mode_get";
+  getXIntegration: "get_x_integration_social_listeners_integrations_x_get";
+  listAbmCompanies: "list_abm_companies_intent_abm_companies_get";
+  listCompanyHiringJobs: "list_company_hiring_jobs_hiring_signals_companies__linkedin_company_id__jobs_get";
+  listCompanyLinkedinPosts: "list_company_linkedin_posts_hiring_signals_companies__linkedin_company_id__linkedin_posts_get";
+  listJobChangeSignals: "list_job_change_signals_hiring_signals_job_changes_get";
+  listListeners: "list_listeners_social_listeners_get";
+  listPostsByContact: "list_posts_by_contact_social_listeners_posts_by_contact__contact_id__get";
+  listSourceLists: "list_source_lists_social_listeners_source_lists_get";
+  listTopEngagedAccounts: "list_top_engaged_accounts_social_listeners_engagements_top_accounts_get";
+  markPost: "mark_post_social_listeners_posts__post_id__mark_post";
+  matchJobChangeSignals: "match_job_change_signals_hiring_signals_job_changes_match_post";
+  previewKeywordUrls: "preview_keyword_urls_intent_keywords_preview_post";
+  previewListenerCost: "preview_listener_cost_social_listeners_preview_cost_post";
+  proposeHiringKeywords: "propose_hiring_keywords_intent_keywords_auto_seed_proposals_post";
+  resolveHiringCompanyIds: "resolve_hiring_company_ids_hiring_signals_companies_resolve_ids_post";
+  resolveJobsForKeyword: "resolve_jobs_for_keyword_intent_keywords__keyword_id__job_resolution_post";
+  rollupAbmCompanies: "rollup_abm_companies_intent_abm_rollup_post";
+  saveIntentToContactMetadata: "save_intent_to_contact_metadata_intent_contacts_metadata_post";
+  saveKeywordSyncConfig: "save_keyword_sync_config_intent_keywords__keyword_id__sync_config_patch";
+  savePostAuthorAsContact: "save_post_author_as_contact_social_listeners_posts__post_id__save_contact_post";
+  searchHiringAggregators: "search_hiring_aggregators_hiring_signals_aggregators_post";
+  searchHiringCompanies: "search_hiring_companies_hiring_signals_companies_post";
+  searchHiringDecisionMakers: "search_hiring_decision_makers_hiring_signals_decision_makers_post";
+  searchHiringJobs: "search_hiring_jobs_hiring_signals_jobs_post";
+  searchHiringRecruiters: "search_hiring_recruiters_hiring_signals_recruiters_post";
+  searchMatchedPosts: "search_matched_posts_social_listeners_posts_search_post";
+  searchPostEngagements: "search_post_engagements_social_listeners_posts__post_id__engagements_search_post";
+  testXCredentials: "test_x_credentials_social_listeners_integrations_x_test_post";
+  triggerKeywordSync: "trigger_keyword_sync_intent_keywords__keyword_id__sync_post";
+  updateHiringKeyword: "update_hiring_keyword_intent_keywords__keyword_id__patch";
+  updateListener: "update_listener_social_listeners__listener_id__patch";
+  updateSocialSettings: "update_social_settings_social_listeners_settings_patch";
+}
+
+/** Input and output of every `g8.api.signals` operation, keyed by operationId. */
+export interface SignalsOperations {
+  /**
+   * POST /social-listeners/posts/{post_id}/engagements/add-to-list
+   * Add Engagers To List
+   * tier: billable · scope: intent:run
+   */
+  add_engagers_to_list_social_listeners_posts__post_id__engagements_add_to_list_post: {
+    input: {
+    path: {
+      /** The post's platform-native id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AddEngagersToListRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/posts/{post_id}/add-to-sequence
+   * Add Post Author To Sequence
+   * tier: external · scope: intent:run
+   */
+  add_post_author_to_sequence_social_listeners_posts__post_id__add_to_sequence_post: {
+    input: {
+    path: {
+      /** The post's platform-native id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AddPostToSequenceRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/auto-seed/all
+   * Auto Seed All Listeners
+   * tier: billable · scope: intent:run
+   */
+  auto_seed_all_listeners_social_listeners_auto_seed_all_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SeedChannelsRequest | null;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/auto-seed/brand
+   * Auto Seed Brand Listener
+   * tier: billable · scope: intent:run
+   */
+  auto_seed_brand_listener_social_listeners_auto_seed_brand_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/auto-seed/competitors
+   * Auto Seed Competitor Listeners
+   * tier: billable · scope: intent:run
+   */
+  auto_seed_competitor_listeners_social_listeners_auto_seed_competitors_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/auto-seed/engagement
+   * Auto Seed Engagement Listeners
+   * tier: billable · scope: intent:run
+   */
+  auto_seed_engagement_listeners_social_listeners_auto_seed_engagement_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SeedChannelsRequest | null;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/auto-seed/keywords
+   * Auto Seed Keyword Listeners
+   * tier: billable · scope: intent:run
+   */
+  auto_seed_keyword_listeners_social_listeners_auto_seed_keywords_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/bulk-from-list
+   * Bulk Create Listeners From List
+   * tier: billable · scope: intent:run
+   */
+  bulk_create_listeners_from_list_social_listeners_bulk_from_list_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BulkCreateFromListRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/integrations/x
+   * Connect X Credentials
+   * tier: billable · scope: intent:run
+   */
+  connect_x_credentials_social_listeners_integrations_x_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: XApiCredentialsRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners
+   * Create Listener
+   * tier: billable · scope: intent:run
+   */
+  create_listener_social_listeners_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateListenerRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * DELETE /intent/keyword-urls/{url_id}
+   * Delete Keyword Url
+   * tier: destructive · scope: intent:delete
+   */
+  delete_keyword_url_intent_keyword_urls__url_id__delete: {
+    input: {
+    path: {
+      /** The keyword URL's id. */
+      url_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * DELETE /social-listeners/{listener_id}
+   * Delete Listener
+   * tier: destructive · scope: intent:delete
+   */
+  delete_listener_social_listeners__listener_id__delete: {
+    input: {
+    path: {
+      /** The listener's id. */
+      listener_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * DELETE /social-listeners/integrations/x
+   * Disconnect X Credentials
+   * tier: destructive · scope: intent:delete
+   */
+  disconnect_x_credentials_social_listeners_integrations_x_delete: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /social-listeners/queries/generate
+   * Generate Listener Query
+   * tier: billable · scope: intent:run
+   */
+  generate_listener_query_social_listeners_queries_generate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: GenerateQueryRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /intent/abm/companies/{company_id}/personas
+   * Get Abm Company Personas
+   * tier: read · scope: intent:read
+   */
+  get_abm_company_personas_intent_abm_companies__company_id__personas_get: {
+    input: {
+    path: {
+      /** Company id. */
+      company_id: number;
+    };
+    query?: {
+      /** Look-back window in days. */
+      days?: number;
+      /** The same three modes as a keyword's sync config, so this previews what a sync exports. */
+      export_mode?: "signals_only" | "icp_plus_signals" | "all_icp_personas";
+      /** Score against this ICP. */
+      icp_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * GET /social-listeners/auto-seed-status
+   * Get Auto Seed Status
+   * tier: read · scope: intent:read
+   */
+  get_auto_seed_status_social_listeners_auto_seed_status_get: {
+    input: {
+    query?: {
+      /** A job id from `/auto-seed/all`. Omit for the most recent run. */
+      job_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /hiring-signals/companies/job-counts
+   * Get Company Job Counts
+   * tier: billable · scope: intent:run
+   */
+  get_company_job_counts_hiring_signals_companies_job_counts_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CompanyJobCountsRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * GET /hiring-signals/jobs/{job_id}
+   * Get Hiring Job Details
+   * tier: read · scope: intent:read
+   */
+  get_hiring_job_details_hiring_signals_jobs__job_id__get: {
+    input: {
+    path: {
+      /** Job id. */
+      job_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_JobDetails_;
+  };
+  /**
+   * GET /intent/keywords/{keyword_id}/job-resolution
+   * Get Job Resolution Status
+   * tier: read · scope: intent:read
+   */
+  get_job_resolution_status_intent_keywords__keyword_id__job_resolution_get: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * GET /intent/keywords/{keyword_id}/sync-config
+   * Get Keyword Sync Config
+   * tier: read · scope: intent:read
+   */
+  get_keyword_sync_config_intent_keywords__keyword_id__sync_config_get: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * GET /social-listeners/{listener_id}
+   * Get Listener
+   * tier: read · scope: intent:read
+   */
+  get_listener_social_listeners__listener_id__get: {
+    input: {
+    path: {
+      /** The listener's id. */
+      listener_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /social-listeners/settings
+   * Get Social Settings
+   * tier: read · scope: intent:read
+   */
+  get_social_settings_social_listeners_settings_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /social-listeners/stats
+   * Get Social Stats
+   * tier: read · scope: intent:read
+   */
+  get_social_stats_social_listeners_stats_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /social-listeners/integrations/x/mode
+   * Get X Effective Mode
+   * tier: read · scope: intent:read
+   */
+  get_x_effective_mode_social_listeners_integrations_x_mode_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /social-listeners/integrations/x
+   * Get X Integration
+   * tier: read · scope: intent:read
+   */
+  get_x_integration_social_listeners_integrations_x_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * GET /intent/abm/companies
+   * List Abm Companies
+   * tier: read · scope: intent:read
+   */
+  list_abm_companies_intent_abm_companies_get: {
+    input: {
+    query?: {
+      /** Look-back window in days. */
+      days?: number;
+      /** Comma-separated keyword ids to restrict to. */
+      keyword_ids?: string | null;
+      /** Score against this ICP. */
+      icp_id?: string | null;
+      page?: number;
+      limit?: number;
+      /** Grid filter model as JSON, passed through unchanged. */
+      agFilterModel?: string | null;
+      /** Grid sort model as JSON (`colId`, `sort`). */
+      agSortModel?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * GET /hiring-signals/companies/{linkedin_company_id}/jobs
+   * List Company Hiring Jobs
+   * tier: read · scope: intent:read
+   */
+  list_company_hiring_jobs_hiring_signals_companies__linkedin_company_id__jobs_get: {
+    input: {
+    path: {
+      /** LinkedIn company id (lcid). */
+      linkedin_company_id: number;
+    };
+    query?: {
+      limit?: number;
+      window_days?: number;
+      /** Expand the lcid to its subsidiaries, so a parent company's view surfaces postings made under a child lcid. On by default because the parent is usually who the customer is selling to. */
+      include_subsidiaries?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * GET /hiring-signals/companies/{linkedin_company_id}/linkedin-posts
+   * List Company Linkedin Posts
+   * tier: read · scope: intent:read
+   */
+  list_company_linkedin_posts_hiring_signals_companies__linkedin_company_id__linkedin_posts_get: {
+    input: {
+    path: {
+      /** LinkedIn company id (lcid). */
+      linkedin_company_id: number;
+    };
+    query?: {
+      limit?: number;
+      /** Optional age cap in days. OMIT to get the newest posts regardless of age. */
+      window_days?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * GET /hiring-signals/job-changes
+   * List Job Change Signals
+   * tier: read · scope: intent:read
+   */
+  list_job_change_signals_hiring_signals_job_changes_get: {
+    input: {
+    query?: {
+      /** Filter to a single contact. */
+      contact_id?: number | null;
+      /** Filter to a single Talent Moves listener. */
+      listener_id?: string | null;
+      /** Only events detected at or after this ISO timestamp. */
+      since?: string | null;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_JobChangeSignalsResponse_;
+  };
+  /**
+   * GET /social-listeners
+   * List Listeners
+   * tier: read · scope: intent:read
+   */
+  list_listeners_social_listeners_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * GET /social-listeners/posts/by-contact/{contact_id}
+   * List Posts By Contact
+   * tier: read · scope: intent:read
+   */
+  list_posts_by_contact_social_listeners_posts_by_contact__contact_id__get: {
+    input: {
+    path: {
+      /** Contact id. */
+      contact_id: number;
+    };
+    query?: {
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * GET /social-listeners/source-lists
+   * List Source Lists
+   * tier: read · scope: intent:read
+   */
+  list_source_lists_social_listeners_source_lists_get: {
+    input: {
+    query?: {
+      /** Filter to one audience type. */
+      audience_type?: string | null;
+      /** Only lists still in use. */
+      active_only?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * GET /social-listeners/engagements/top-accounts
+   * List Top Engaged Accounts
+   * tier: read · scope: intent:read
+   */
+  list_top_engaged_accounts_social_listeners_engagements_top_accounts_get: {
+    input: {
+    query?: {
+      days?: number;
+      platform?: ("x" | "linkedin" | "reddit" | "instagram" | "youtube") | null;
+      /** Only accounts that engaged this often. */
+      min_posts?: number;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * POST /social-listeners/posts/{post_id}/mark
+   * Mark Post
+   * tier: billable · scope: intent:run
+   */
+  mark_post_social_listeners_posts__post_id__mark_post: {
+    input: {
+    path: {
+      /** The post's platform-native id. */
+      post_id: string;
+    };
+    query?: {
+      /** Which platform the post id belongs to. */
+      platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: MarkPostRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /hiring-signals/job-changes/match
+   * Match Job Change Signals
+   * tier: billable · scope: intent:run
+   */
+  match_job_change_signals_hiring_signals_job_changes_match_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobChangeMatchRequest;
+  };
+    output: ApiResponse_JobChangeSignalsResponse_;
+  };
+  /**
+   * POST /intent/keywords/preview
+   * Preview Keyword Urls
+   * tier: read · scope: intent:read
+   */
+  preview_keyword_urls_intent_keywords_preview_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PreviewKeywordUrlsRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * POST /social-listeners/preview-cost
+   * Preview Listener Cost
+   * tier: read · scope: intent:read
+   */
+  preview_listener_cost_social_listeners_preview_cost_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PreviewCostRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /intent/keywords/auto-seed-proposals
+   * Propose Hiring Keywords
+   * tier: billable · scope: intent:run
+   */
+  propose_hiring_keywords_intent_keywords_auto_seed_proposals_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AutoSeedProposalsRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * POST /hiring-signals/companies/resolve-ids
+   * Resolve Hiring Company Ids
+   * tier: billable · scope: intent:run
+   */
+  resolve_hiring_company_ids_hiring_signals_companies_resolve_ids_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ResolveCompanyIdsRequest;
+  };
+    output: ApiResponse_dict_;
+  };
+  /**
+   * POST /intent/keywords/{keyword_id}/job-resolution
+   * Resolve Jobs For Keyword
+   * tier: billable · scope: intent:run
+   */
+  resolve_jobs_for_keyword_intent_keywords__keyword_id__job_resolution_post: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * POST /intent/abm/rollup
+   * Rollup Abm Companies
+   * tier: read · scope: intent:read
+   */
+  rollup_abm_companies_intent_abm_rollup_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AbmRollupRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * POST /intent/contacts/metadata
+   * Save Intent To Contact Metadata
+   * tier: billable · scope: intent:run
+   */
+  save_intent_to_contact_metadata_intent_contacts_metadata_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SaveIntentToMetadataRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * PATCH /intent/keywords/{keyword_id}/sync-config
+   * Save Keyword Sync Config
+   * tier: billable · scope: intent:run
+   */
+  save_keyword_sync_config_intent_keywords__keyword_id__sync_config_patch: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: KeywordSyncConfigRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * POST /social-listeners/posts/{post_id}/save-contact
+   * Save Post Author As Contact
+   * tier: billable · scope: intent:run
+   */
+  save_post_author_as_contact_social_listeners_posts__post_id__save_contact_post: {
+    input: {
+    path: {
+      /** The post's platform-native id. */
+      post_id: string;
+    };
+    query?: {
+      platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /hiring-signals/aggregators
+   * Search Hiring Aggregators
+   * tier: billable · scope: intent:run
+   */
+  search_hiring_aggregators_hiring_signals_aggregators_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobSearchRequest;
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * POST /hiring-signals/companies
+   * Search Hiring Companies
+   * tier: billable · scope: intent:run
+   */
+  search_hiring_companies_hiring_signals_companies_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobSearchRequest;
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * POST /hiring-signals/decision-makers
+   * Search Hiring Decision Makers
+   * tier: billable · scope: intent:run
+   */
+  search_hiring_decision_makers_hiring_signals_decision_makers_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobSearchRequest;
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * POST /hiring-signals/jobs
+   * Search Hiring Jobs
+   * tier: billable · scope: intent:run
+   */
+  search_hiring_jobs_hiring_signals_jobs_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobSearchRequest;
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * POST /hiring-signals/recruiters
+   * Search Hiring Recruiters
+   * tier: billable · scope: intent:run
+   */
+  search_hiring_recruiters_hiring_signals_recruiters_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: JobSearchRequest;
+  };
+    output: ApiResponse_JobSearchResponse_;
+  };
+  /**
+   * POST /social-listeners/posts/search
+   * Search Matched Posts
+   * tier: read · scope: intent:read
+   */
+  search_matched_posts_social_listeners_posts_search_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SearchPostsRequest;
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * POST /social-listeners/posts/{post_id}/engagements/search
+   * Search Post Engagements
+   * tier: read · scope: intent:read
+   */
+  search_post_engagements_social_listeners_posts__post_id__engagements_search_post: {
+    input: {
+    path: {
+      /** The post's platform-native id. */
+      post_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SearchPostEngagementsRequest;
+  };
+    output: ApiResponse_SocialCollection_;
+  };
+  /**
+   * POST /social-listeners/integrations/x/test
+   * Test X Credentials
+   * tier: billable · scope: intent:run
+   */
+  test_x_credentials_social_listeners_integrations_x_test_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: XApiCredentialsRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * POST /intent/keywords/{keyword_id}/sync
+   * Trigger Keyword Sync
+   * tier: billable · scope: intent:run
+   */
+  trigger_keyword_sync_intent_keywords__keyword_id__sync_post: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * PATCH /intent/keywords/{keyword_id}
+   * Update Hiring Keyword
+   * tier: billable · scope: intent:run
+   */
+  update_hiring_keyword_intent_keywords__keyword_id__patch: {
+    input: {
+    path: {
+      /** The keyword's id. */
+      keyword_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateKeywordRequest;
+  };
+    output: ApiResponse_IntentPayload_;
+  };
+  /**
+   * PATCH /social-listeners/{listener_id}
+   * Update Listener
+   * tier: billable · scope: intent:run
+   */
+  update_listener_social_listeners__listener_id__patch: {
+    input: {
+    path: {
+      /** The listener's id. */
+      listener_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PatchListenerRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+  /**
+   * PATCH /social-listeners/settings
+   * Update Social Settings
+   * tier: billable · scope: intent:run
+   */
+  update_social_settings_social_listeners_settings_patch: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PatchSocialSettingsRequest;
+  };
+    output: ApiResponse_SocialPayload_;
+  };
+}
+
+// 40 schemas referenced above (the same as G8Contract.<Name>).
+
+/** Intent totals for a named set of accounts. */
+export interface AbmRollupRequest {
+  /** Company ids, at most 500 per call - the app refuses more; chunk larger sets. */
+  company_ids: Array<number>;
+  /** Look-back window in days. */
+  days?: number;
+}
+
+/**
+ * Turn the people who engaged with a post into a graph8 list.
+ *
+ * Supply `audience_id` to add to an existing list, or `audience_name` to
+ * create one. Contacts that do not exist yet are created as stubs.
+ */
+export interface AddEngagersToListRequest {
+  /** An existing graph8 list. */
+  audience_id?: string | null;
+  /** Create a new graph8 list with this name. */
+  audience_name?: string | null;
+  /** Only commenters, or only reactors. Omit for both. */
+  engagement_type?: ("comment" | "reaction") | null;
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+  /** Optional echo of the path id. The PATH value is authoritative. */
+  post_external_id?: string | null;
+}
+
+/**
+ * Enrol a post's author into a sequence.
+ *
+ * ASYNCHRONOUS. This resolves the author to a contact and publishes an
+ * enrolment request; the sequencer picks it up afterwards. A 200 means the
+ * request was accepted, not that the person is enrolled.
+ */
+export interface AddPostToSequenceRequest {
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+  sequence_id: string;
+}
+
+export interface ApiResponse_IntentPayload_ {
+  data: IntentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_JobChangeSignalsResponse_ {
+  data: JobChangeSignalsResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_JobDetails_ {
+  data: JobDetails;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_JobSearchResponse_ {
+  data: JobSearchResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialCollection_ {
+  data: SocialCollection;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SocialPayload_ {
+  data: SocialPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+/** Propose hiring keywords from the org's own context. */
+export interface AutoSeedProposalsRequest {
+  /** `jobs` (Hiring Wave) or `job_changes` (Talent Moves). */
+  signal_type?: "jobs" | "job_changes";
+}
+
+/**
+ * Create one `user` listener per social profile on a graph8 list.
+ *
+ * No platform lookup happens here - handles are resolved lazily by the
+ * polling worker, so this does not consume quota per row at creation time.
+ */
+export interface BulkCreateFromListRequest {
+  /** The graph8 audience to read profiles from. */
+  list_id: number;
+  /** Only `user` listeners can be bulk-created from a list. */
+  listener_type?: "user";
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+  /** Create one listener per platform. Overrides `platform`. */
+  platforms?: (Array<"x" | "linkedin" | "reddit" | "instagram" | "youtube">) | null;
+}
+
+/** Per-channel spend and volume ceilings. */
+export interface ChannelSettingsRule {
+  enabled?: boolean;
+  /** Fetch who engaged with each matched post. Multiplies what a poll costs. */
+  fetch_engagements?: boolean;
+  max_comments_per_post?: number;
+  max_reactions_per_post?: number;
+  monthly_credit_cap?: number;
+  per_poll_result_cap?: number;
+}
+
+/** Active-job counts for a page of companies. */
+export interface CompanyJobCountsRequest {
+  /** LinkedIn company ids (lcids). Capped at 1000 - one grid page, not a corpus scan. */
+  linkedin_company_ids?: Array<number>;
+  window_days?: number;
+}
+
+/** When a matched post's author becomes a graph8 contact. */
+export interface ContactCaptureRule {
+  enabled?: boolean;
+  min_followers?: number;
+  only_when_classified?: boolean;
+}
+
+/**
+ * Start watching something. THIS CAN SPEND CREDITS.
+ *
+ * A `brand` listener with no `query` builds one with an LLM call, which is
+ * charged. Every other combination writes a row and the polling worker does
+ * the fetching from then on.
+ */
+export interface CreateListenerRequest {
+  filters?: Record<string, unknown>;
+  /** Rebuild a brand query even though one exists. Spends a credit to do it. */
+  force_rebuild_brand?: boolean;
+  /** `brand` and `competitor` watch a named entity, `keyword` watches a query, `engagement` watches an ICP-shaped bucket, `user` watches one account's posts. */
+  listener_type: "brand" | "competitor" | "keyword" | "engagement" | "user";
+  /** Per-listener ceiling on credits. The one field that BOUNDS what this costs. */
+  monthly_credit_cap?: number | null;
+  name: string;
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+  /** How often the worker polls. Shorter means more matches AND more spend. */
+  poll_interval_sec?: number | null;
+  /** Platform-native search query. OMITTING this on a `brand` listener makes the app build one with an LLM call, which SPENDS CREDITS. Supply a query, or call `POST /social-listeners/queries/generate` first if you want to see it before committing. */
+  query?: string | null;
+  /** Required for a `user` listener: the account to watch. */
+  target_handle?: string | null;
+}
+
+/**
+ * Turn a plain-English description into a platform-native query.
+ *
+ * THIS SPENDS CREDITS - it is an LLM call. It returns the query rather than
+ * creating a listener, so you can read it before committing to one.
+ */
+export interface GenerateQueryRequest {
+  description: string;
+  listener_type: "brand" | "competitor" | "keyword" | "engagement" | "user";
+}
+
+/**
+ * One intent object or handler response.
+ *
+ * Open-shaped: these payloads carry corpus detail that grows with the corpus.
+ * A list result is returned under `items`.
+ */
+export type IntentPayload = Record<string, unknown>;
+
+/** Look up which LinkedIn profiles changed job recently. */
+export interface JobChangeMatchRequest {
+  /** LinkedIn profile URLs to match against the last 90 days of job-change events. */
+  linkedin_urls: Array<string>;
+}
+
+/**
+ * Job-change events for this org.
+ *
+ * Identifying fields are REDACTED unless the caller holds a Signals write
+ * capability - these are real named people who moved employer, which is
+ * exactly the data a read-only role is not meant to export.
+ */
+export interface JobChangeSignalsResponse {
+  signals?: Array<Record<string, unknown>>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+/** One posting, with its company, recruiter and the company's other jobs. */
+export interface JobDetails {
+  company_name?: string | null;
+  job_id?: number | null;
+  job_location?: string | null;
+  linkedin_company_id?: number | null;
+  posted_at?: string | null;
+  title?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * One request shape for every Hiring Signals tab.
+ *
+ * The app uses a single command for all of them deliberately - the form is
+ * flat, and each handler needs both the base filters and the persona half.
+ * Splitting them here would just add a layer the routes flatten back out.
+ */
+export interface JobSearchRequest {
+  contacts_per_company?: number;
+  /** Drop postings from job-board aggregators. On by default because an aggregator is not a company that is hiring - it is a company that lists other people's jobs. `/jobs/search/aggregators` returns exactly what this suppressed, so a caller can audit it. */
+  exclude_aggregators?: boolean;
+  /** Run the recruiter aggregation and enrichment hop. Set false to skip two round-trips when only Companies and Decision-makers are needed. */
+  include_recruiters?: boolean;
+  /** Job-title keywords. OR semantics - any match counts. */
+  keywords: Array<string>;
+  /** Page size. Capped at 200 to bound the ClickHouse cost. */
+  limit?: number;
+  /** Free-text token matched case-insensitively against the job location. */
+  location_contains?: string | null;
+  offset?: number;
+  /** Scope to one parent company and its subsidiaries. Omit to search everywhere. */
+  parent_linkedin_company_id?: number | null;
+  /** Max postings counted per company. */
+  per_company_cap?: number;
+  /** Decision-maker department filter. */
+  persona_department?: Array<string> | null;
+  /** Decision-maker seniority filter. */
+  persona_seniority?: Array<string> | null;
+  /** Decision-maker title substring filter. */
+  persona_title_contains?: string | null;
+  /** Recruiter paging, INDEPENDENT of `limit`/`offset`: one recruiter can serve many companies, so the two counts diverge and a caller can page one tab without touching the other. */
+  recruiter_limit?: number;
+  recruiter_offset?: number;
+  /** How far back to look for postings. */
+  window_days?: number;
+}
+
+/**
+ * A page of Hiring Signals results.
+ *
+ * Rows stay open dicts: each tab (jobs, companies, decision-makers,
+ * recruiters, aggregators) returns a different shape assembled from
+ * ClickHouse plus OpenSearch, and the columns move as enrichment improves.
+ */
+export interface JobSearchResponse {
+  results?: Array<Record<string, unknown>>;
+  total?: number;
+  [key: string]: unknown;
+}
+
+/**
+ * The filters a keyword's URL set is shaped by.
+ *
+ * Mirrors the app's `KeywordSearchFilters`, including its bounds. Keys beyond
+ * the typed ones are accepted and passed through, as the app accepts them.
+ */
+export interface KeywordFilters {
+  /** `b2b`, `b2c` or `both`. */
+  audience?: "b2b" | "b2c" | "both";
+  /** Domains to drop. */
+  exclude_domains?: Array<string>;
+  /** Page types to drop from the URL set. */
+  exclude_page_types?: Array<"news" | "finance" | "forum" | "vendor_marketing">;
+  /** Run a model pass over candidate pages. */
+  llm_triage?: boolean;
+  /** Soft cap so no single domain dominates the set. */
+  max_urls_per_domain?: number;
+  /** Drop pages scored below this commercial intent. */
+  min_commercial_intent_level?: number;
+  [key: string]: unknown;
+}
+
+/** Wire a keyword to a list, optionally on a schedule. */
+export interface KeywordSyncConfigRequest {
+  /** Push on a schedule, without anyone calling anything, rather than only on request. */
+  auto_sync_enabled?: boolean;
+  /** Buying committee whose personas are exported. */
+  committee_id?: string | null;
+  /** `signals_only` exports only the people a signal named; `icp_plus_signals` adds the ICP's personas at those companies; `all_icp_personas` exports every persona regardless of signal. */
+  export_mode?: "signals_only" | "icp_plus_signals" | "all_icp_personas";
+  /** Score matches against this ICP. */
+  icp_id?: string | null;
+  /** The list matches are pushed into. */
+  list_id?: number | null;
+}
+
+/** Triage one matched post. */
+export interface MarkPostRequest {
+  status: "reviewed" | "dismissed";
+}
+
+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;
+}
+
+/**
+ * Partial update. Omitted fields are left alone.
+ *
+ * Changing `target_handle` on a `user` listener re-resolves the account
+ * against the platform, which consumes X API quota.
+ */
+export interface PatchListenerRequest {
+  filters?: Record<string, unknown> | null;
+  /** False pauses polling without deleting the listener. */
+  is_active?: boolean | null;
+  monthly_credit_cap?: number | null;
+  name?: string | null;
+  poll_interval_sec?: number | null;
+  query?: string | null;
+  target_handle?: string | null;
+}
+
+/**
+ * Org-wide social listening settings. Omitted fields are left alone.
+ *
+ * This is the surface that BOUNDS what the whole feature costs -
+ * `monthly_credit_cap`, the per-channel caps and `auto_pause_on_cap` between
+ * them decide whether an over-eager listener can keep spending.
+ */
+export interface PatchSocialSettingsRequest {
+  /** Alert at this percentage of the cap. */
+  alert_threshold_pct?: number | null;
+  auto_archive_days?: number | null;
+  auto_create_contacts?: boolean | null;
+  /** Stop polling when the cap is reached, rather than alerting. */
+  auto_pause_on_cap?: boolean | null;
+  /** Keyed by platform. Keys the app does not recognise are dropped by its own merge - it rebuilds the map from the supported set. */
+  channel_settings?: Record<string, ChannelSettingsRule> | null;
+  classifier_model?: string | null;
+  contact_capture?: Record<string, ContactCaptureRule> | null;
+  monthly_credit_cap?: number | null;
+  /** Org-wide monthly credit ceiling across the non-X channels (LinkedIn, Reddit, Instagram, YouTube) together. 0 means no org-wide ceiling; the per-channel caps in `channel_settings` still apply. */
+  other_channels_monthly_credit_cap?: number | null;
+}
+
+/** Ask what a listener WOULD cost. Charges nothing. */
+export interface PreviewCostRequest {
+  listener_type: "brand" | "competitor" | "keyword" | "engagement" | "user";
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+  /** The interval to cost. Shorter intervals cost more. */
+  poll_interval_sec?: number;
+  query?: string | null;
+  target_handle?: string | null;
+}
+
+/** What a keyword WOULD match, without creating it. */
+export interface PreviewKeywordUrlsRequest {
+  /** The keyword to preview. */
+  keyword: string;
+  /** Filters to preview it with. */
+  search_filters?: KeywordFilters;
+}
+
+/**
+ * Turn LinkedIn company ids into graph8 company ids.
+ *
+ * This is what makes a Hiring Signals result actionable: the search returns
+ * lcids, and a list or a sequence needs graph8 ids. The handler caps the
+ * input server-side regardless of what is sent.
+ */
+export interface ResolveCompanyIdsRequest {
+  linkedin_company_ids?: Array<number>;
+}
+
+/**
+ * Write each contact's resolved intent onto the contact record.
+ *
+ * No `org_id`: the org is the authenticated key's own.
+ */
+export interface SaveIntentToMetadataRequest {
+  /** Overwrite intent metadata already on a contact, rather than only filling gaps. */
+  force_update?: boolean;
+}
+
+/** Filters over engagements ALREADY stored against a post. */
+export interface SearchPostEngagementsRequest {
+  engagement_type?: ("comment" | "reaction") | null;
+  limit?: number;
+  page?: number;
+  platform?: "x" | "linkedin" | "reddit" | "instagram" | "youtube";
+}
+
+/** Filters over posts ALREADY matched and stored. Fetches nothing live. */
+export interface SearchPostsRequest {
+  /** Grid-style filter expressions, passed through unchanged. Their grammar is the app's, not this contract's - a typed model here would freeze a filter language that still moves. */
+  conditions?: Array<Record<string, unknown>>;
+  /** Only posts whose author resolved to a graph8 contact. */
+  has_contact?: boolean | null;
+  /** Hide posts the classifier scored confidently LOW (< 0.5), while keeping never-classified ones visible. Not the same as `min_score=0.5`, which would also hide the unscored. */
+  hide_low_confidence?: boolean | null;
+  limit?: number;
+  listener_id?: string | null;
+  max_score?: number | null;
+  min_score?: number | null;
+  page?: number;
+  platform?: ("x" | "linkedin" | "reddit" | "instagram" | "youtube") | null;
+  since?: string | null;
+  /** `new`, `reviewed` or `dismissed`. */
+  status?: string | null;
+  until?: string | null;
+}
+
+/** Which channels an auto-seed targets. Defaults to X alone. */
+export interface SeedChannelsRequest {
+  channels?: (Array<"x" | "linkedin" | "reddit" | "instagram" | "youtube">) | null;
+}
+
+/**
+ * A list of social-listening objects. A bare list is surfaced as `items`;
+ * a named collection keeps its key AND gains `items`.
+ */
+export interface SocialCollection {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * One social-listening object, or one handler response.
+ *
+ * Open-shaped: these payloads carry per-platform detail that differs between
+ * X, LinkedIn, Reddit, Instagram and YouTube and grows with them.
+ */
+export type SocialPayload = Record<string, unknown>;
+
+/**
+ * Partial update of a HIRING listener (`jobs` / `job_changes` keyword).
+ *
+ * Omitted fields are left alone. The app refuses a plain intent keyword here
+ * with a 404; its filters are replaced with `POST /intent/keywords/{id}/filters`.
+ */
+export interface UpdateKeywordRequest {
+  /** The listener's name. Must not be blank. */
+  keyword?: string | null;
+  /** FULL REPLACEMENT of the filter object, not a merge - filters left out are dropped. `window_days` must be 1-365 and `contacts_per_company` 1-50 when present. */
+  search_filters?: Record<string, unknown> | null;
+  /** Talent Moves watchlist scope, as a JSON-encoded string. */
+  watchlist_source?: string | null;
+}
+
+/**
+ * An X developer app's key and secret.
+ *
+ * WRITE-ONLY. Neither value, nor the bearer token derived from them, is ever
+ * returned by any route on this surface - `GET /social-listeners/integrations/x`
+ * reports whether a connection exists, not what it is.
+ */
+export interface XApiCredentialsRequest {
+  /** X Developer App API key (consumer key). */
+  api_key: string;
+  /** X Developer App API secret. */
+  api_secret: string;
+}