@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/surveys.d.ts

@@ -0,0 +1,847 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.surveys` (Surveys): 21 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"create_survey_feedback_surveys_post">;
+ *
+ * Reference with examples: surveys.md
+ */
+/* eslint-disable */
+
+/** `g8.api.surveys.<member>` -> the operationId it calls. */
+export interface SurveysMembers {
+  createSurvey: "create_survey_feedback_surveys_post";
+  createSurveyTrigger: "create_survey_trigger_feedback_surveys__survey_id__triggers_post";
+  deleteSurvey: "delete_survey_feedback_surveys__survey_id__delete";
+  deleteSurveyTrigger: "delete_survey_trigger_feedback_surveys__survey_id__triggers__trigger_id__delete";
+  getCompanySurveyNps: "get_company_survey_nps_feedback_companies__company_id__nps_get";
+  getContactSurveyHistory: "get_contact_survey_history_feedback_contacts__contact_id__history_get";
+  getSurvey: "get_survey_feedback_surveys__survey_id__get";
+  getSurveyAppUserResponses: "get_survey_app_user_responses_feedback_surveys__survey_id__app_user_responses_get";
+  getSurveyOrgSummary: "get_survey_org_summary_feedback_org_summary_get";
+  getSurveyResponses: "get_survey_responses_feedback_surveys__survey_id__responses_get";
+  getSurveySend: "get_survey_send_feedback_sends__send_id__get";
+  getSurveySends: "get_survey_sends_feedback_surveys__survey_id__sends_get";
+  getSurveySummary: "get_survey_summary_feedback_surveys__survey_id__summary_get";
+  getSurveyTrends: "get_survey_trends_feedback_surveys__survey_id__trends_get";
+  listSurveySendingDomains: "list_survey_sending_domains_feedback_sending_domains_get";
+  listSurveyTriggers: "list_survey_triggers_feedback_surveys__survey_id__triggers_get";
+  listSurveys: "list_surveys_feedback_surveys_get";
+  sendSurvey: "send_survey_feedback_surveys__survey_id__send_post";
+  surveyDomainStatus: "survey_domain_status_feedback_sending_domains_status_get";
+  updateSurvey: "update_survey_feedback_surveys__survey_id__patch";
+  verifySurveyDomain: "verify_survey_domain_feedback_sending_domains_verify_post";
+}
+
+/** Input and output of every `g8.api.surveys` operation, keyed by operationId. */
+export interface SurveysOperations {
+  /**
+   * POST /feedback/surveys
+   * Create Survey
+   * tier: write · scope: surveys:write
+   */
+  create_survey_feedback_surveys_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateSurveyRequest;
+  };
+    output: ApiResponse_SurveyResponseDTO_;
+  };
+  /**
+   * POST /feedback/surveys/{survey_id}/triggers
+   * Create Survey Trigger
+   * tier: write · scope: surveys:write
+   */
+  create_survey_trigger_feedback_surveys__survey_id__triggers_post: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateSurveyTriggerRequest;
+  };
+    output: ApiResponse_SurveyTriggerDTO_;
+  };
+  /**
+   * DELETE /feedback/surveys/{survey_id}
+   * Delete Survey
+   * tier: destructive · scope: surveys:delete
+   */
+  delete_survey_feedback_surveys__survey_id__delete: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveyDeleteResponse_;
+  };
+  /**
+   * DELETE /feedback/surveys/{survey_id}/triggers/{trigger_id}
+   * Delete Survey Trigger
+   * tier: destructive · scope: surveys:delete
+   */
+  delete_survey_trigger_feedback_surveys__survey_id__triggers__trigger_id__delete: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+      /** Trigger id — from GET /feedback/surveys/{survey_id}/triggers */
+      trigger_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveyTriggerDeleteResponse_;
+  };
+  /**
+   * GET /feedback/companies/{company_id}/nps
+   * Get Company Survey Nps
+   * tier: read · scope: surveys:read
+   */
+  get_company_survey_nps_feedback_companies__company_id__nps_get: {
+    input: {
+    path: {
+      /** Company id (mashup_companies.id) */
+      company_id: number;
+    };
+    query?: {
+      /** Trend bucket: day, week or month. */
+      bucket?: string;
+      /** Restrict to one survey. Omit to combine every NPS survey. */
+      survey_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CompanyNpsDTO_;
+  };
+  /**
+   * GET /feedback/contacts/{contact_id}/history
+   * Get Contact Survey History
+   * tier: read · scope: surveys:read
+   */
+  get_contact_survey_history_feedback_contacts__contact_id__history_get: {
+    input: {
+    path: {
+      /** Contact id (mashup_contacts.id — the primary key) */
+      contact_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ContactHistoryDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}
+   * Get Survey
+   * tier: read · scope: surveys:read
+   */
+  get_survey_feedback_surveys__survey_id__get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveyResponseDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/app-user-responses
+   * Get Survey App User Responses
+   * tier: read · scope: surveys:read
+   */
+  get_survey_app_user_responses_feedback_surveys__survey_id__app_user_responses_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AppUserResponsesDTO_;
+  };
+  /**
+   * GET /feedback/org-summary
+   * Get Survey Org Summary
+   * tier: read · scope: surveys:read
+   */
+  get_survey_org_summary_feedback_org_summary_get: {
+    input: {
+    query?: {
+      /** Restrict to one audience list id. Omit for all contacts. */
+      segment?: string | null;
+      /** Trend bucket: day, week or month. */
+      bucket?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgSummaryDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/responses
+   * Get Survey Responses
+   * tier: read · scope: surveys:read
+   */
+  get_survey_responses_feedback_surveys__survey_id__responses_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveyResponsesDTO_;
+  };
+  /**
+   * GET /feedback/sends/{send_id}
+   * Get Survey Send
+   * tier: read · scope: surveys:read
+   */
+  get_survey_send_feedback_sends__send_id__get: {
+    input: {
+    path: {
+      /** Send id returned by POST /feedback/surveys/{survey_id}/send */
+      send_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveySendDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/sends
+   * Get Survey Sends
+   * tier: read · scope: surveys:read
+   */
+  get_survey_sends_feedback_surveys__survey_id__sends_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveySendsDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/summary
+   * Get Survey Summary
+   * tier: read · scope: surveys:read
+   */
+  get_survey_summary_feedback_surveys__survey_id__summary_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    query?: {
+      /** Trend bucket: day, week or month. */
+      bucket?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SummaryDTO_;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/trends
+   * Get Survey Trends
+   * tier: read · scope: surveys:read
+   */
+  get_survey_trends_feedback_surveys__survey_id__trends_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    query?: {
+      /** Trend bucket: day, week or month. */
+      bucket?: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_TrendsDTO_;
+  };
+  /**
+   * GET /feedback/sending-domains
+   * List Survey Sending Domains
+   * tier: read · scope: surveys:read
+   */
+  list_survey_sending_domains_feedback_sending_domains_get: {
+    input: {
+    query?: {
+      /** Include domains that are pending or not set up, with their status. */
+      include_unverified?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_SurveySendingDomainDTO__;
+  };
+  /**
+   * GET /feedback/surveys/{survey_id}/triggers
+   * List Survey Triggers
+   * tier: read · scope: surveys:read
+   */
+  list_survey_triggers_feedback_surveys__survey_id__triggers_get: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_SurveyTriggerDTO__;
+  };
+  /**
+   * GET /feedback/surveys
+   * List Surveys
+   * tier: read · scope: surveys:read
+   */
+  list_surveys_feedback_surveys_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_SurveyResponseDTO__;
+  };
+  /**
+   * POST /feedback/surveys/{survey_id}/send
+   * Send Survey
+   * tier: external · scope: surveys:run
+   */
+  send_survey_feedback_surveys__survey_id__send_post: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SendSurveyRequest;
+  };
+    output: ApiResponse_SurveySendAccepted_;
+  };
+  /**
+   * GET /feedback/sending-domains/status
+   * Survey Domain Status
+   * tier: read · scope: surveys:read
+   */
+  survey_domain_status_feedback_sending_domains_status_get: {
+    input: {
+    query: {
+      /** The domain to check. */
+      domain: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SurveyDomainPayload_;
+  };
+  /**
+   * PATCH /feedback/surveys/{survey_id}
+   * Update Survey
+   * tier: write · scope: surveys:write
+   */
+  update_survey_feedback_surveys__survey_id__patch: {
+    input: {
+    path: {
+      /** Survey id (UUID) — from GET /feedback/surveys */
+      survey_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateSurveyRequest;
+  };
+    output: ApiResponse_SurveyResponseDTO_;
+  };
+  /**
+   * POST /feedback/sending-domains/verify
+   * Verify Survey Domain
+   * tier: external · scope: surveys:run
+   */
+  verify_survey_domain_feedback_sending_domains_verify_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VerifySurveyDomainRequest;
+  };
+    output: ApiResponse_SurveyDomainPayload_;
+  };
+}
+
+// 53 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_AppUserResponsesDTO_ {
+  data: AppUserResponsesDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CompanyNpsDTO_ {
+  data: CompanyNpsDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ContactHistoryDTO_ {
+  data: ContactHistoryDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_OrgSummaryDTO_ {
+  data: OrgSummaryDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SummaryDTO_ {
+  data: SummaryDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyDeleteResponse_ {
+  data: SurveyDeleteResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyDomainPayload_ {
+  data: SurveyDomainPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyResponseDTO_ {
+  data: SurveyResponseDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyResponsesDTO_ {
+  data: SurveyResponsesDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveySendAccepted_ {
+  data: SurveySendAccepted;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveySendDTO_ {
+  data: SurveySendDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveySendsDTO_ {
+  data: SurveySendsDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyTriggerDTO_ {
+  data: SurveyTriggerDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SurveyTriggerDeleteResponse_ {
+  data: SurveyTriggerDeleteResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_TrendsDTO_ {
+  data: TrendsDTO;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_SurveyResponseDTO__ {
+  data: Array<SurveyResponseDTO>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_SurveySendingDomainDTO__ {
+  data: Array<SurveySendingDomainDTO>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_SurveyTriggerDTO__ {
+  data: Array<SurveyTriggerDTO>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface AppUserResponseRowDTO {
+  app_user_id: string;
+  channel: string;
+  comment?: string | null;
+  responded_at?: string | null;
+  score: number;
+}
+
+export interface AppUserResponsesDTO {
+  responses: Array<AppUserResponseRowDTO>;
+  survey_id: string;
+}
+
+export interface CompanyContactScoreDTO {
+  classification?: string | null;
+  contact_id: number;
+  first_name?: string | null;
+  history?: Array<SurveyScorePointDTO>;
+  last_name?: string | null;
+  last_responded_at?: string | null;
+  responded?: boolean;
+  score?: number | null;
+  trend?: string | null;
+}
+
+export interface CompanyNpsDTO {
+  bucket: string;
+  company_id: number;
+  contacts: Array<CompanyContactScoreDTO>;
+  coverage: CoverageDTO;
+  detractors: number;
+  nps_score?: number | null;
+  passives: number;
+  promoters: number;
+  suppressed: boolean;
+  time_series: Array<TrendBarDTO>;
+  total_respondents: number;
+}
+
+export interface ContactHistoryDTO {
+  contact_id: number;
+  responses: Array<ContactHistoryItemDTO>;
+}
+
+export interface ContactHistoryItemDTO {
+  channel?: string | null;
+  classification?: string | null;
+  responded_at?: string | null;
+  score: number;
+  survey_id: string;
+  survey_name?: string | null;
+  type: string;
+}
+
+export interface CoverageDTO {
+  rate: number;
+  responded: number;
+  total_contacts: number;
+}
+
+export interface CreateSurveyRequest {
+  comment_mode?: string | null;
+  delivery_channel?: string;
+  name: string;
+  question_text: string;
+  scale_max?: number | null;
+  scale_min?: number | null;
+  template_id?: number | null;
+  thank_you_copy?: string | null;
+  type: string;
+}
+
+/**
+ * Configure an automated-send binding (Phase 3, RFC §5).
+ *
+ * - ``scheduled``  : requires ``audience_ref`` + ``cadence_days`` (30/60/90).
+ * - ``list_entry`` : requires ``audience_ref`` (the watch list).
+ * - ``stage_entry``: requires ``stage_value`` (the to_stage slug).
+ */
+export interface CreateSurveyTriggerRequest {
+  audience_ref?: string | null;
+  cadence_days?: number | null;
+  reply_to?: string | null;
+  sender_email: string;
+  sender_name?: string | null;
+  stage_value?: string | null;
+  subject: string;
+  trigger_kind: string;
+}
+
+export interface OrgCsatBlockDTO {
+  csat_avg?: number | null;
+  total_respondents: number;
+}
+
+export interface OrgNpsBlockDTO {
+  detractors: number;
+  nps_score?: number | null;
+  passives: number;
+  promoters: number;
+  total_respondents: number;
+}
+
+export interface OrgSummaryDTO {
+  bucket: string;
+  in_app_csat_avg?: number | null;
+  in_app_respondents?: number;
+  org_csat: OrgCsatBlockDTO;
+  org_nps: OrgNpsBlockDTO;
+  per_survey: Array<PerSurveyDTO>;
+  segment?: string | null;
+  time_series: Array<TrendBarDTO>;
+}
+
+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;
+}
+
+export interface PerSurveyDTO {
+  audience_count?: number | null;
+  audience_name?: string | null;
+  audience_ref?: string | null;
+  cadence_days?: number | null;
+  cadence_kind?: string | null;
+  cadence_label?: string | null;
+  csat_avg?: number | null;
+  delivery_channel?: string | null;
+  detractors: number;
+  is_active?: boolean;
+  name?: string | null;
+  nps_score?: number | null;
+  passives: number;
+  promoters: number;
+  sent_count?: number;
+  status?: string | null;
+  survey_id: string;
+  total_respondents: number;
+  trend?: Array<TrendBarDTO>;
+  type: string;
+}
+
+export interface ResponseRateDTO {
+  rate: number;
+  responded: number;
+  sent: number;
+}
+
+export interface SendDeliveryBreakdownDTO {
+  bounced?: number;
+  delivered?: number;
+  failed?: number;
+  opened?: number;
+  pending?: number;
+  sent?: number;
+}
+
+export interface SendSurveyRequest {
+  audience_ref: string;
+  channel?: string;
+  reply_to?: string | null;
+  scheduled_at?: string | null;
+  sender_email?: string | null;
+  sender_name?: string | null;
+  subject?: string | null;
+}
+
+export interface SummaryDTO {
+  bucket: string;
+  csat_avg?: number | null;
+  delivery_channel: string;
+  detractors: number;
+  dissatisfied?: number | null;
+  neutral?: number | null;
+  nps_score?: number | null;
+  passives: number;
+  promoters: number;
+  response_rate: ResponseRateDTO;
+  satisfied?: number | null;
+  survey_id: string;
+  time_series: Array<TrendBarDTO>;
+  total_respondents: number;
+  type: string;
+}
+
+export interface SurveyDeleteResponse {
+  deleted: boolean;
+  survey_id: string;
+}
+
+/**
+ * An open envelope for a verification result.
+ *
+ * Open because the DNS record set grows: DMARC was added to it after SPF and
+ * DKIM, and closing the shape would have silently dropped the record that
+ * decides whether Gmail accepts the mail at all.
+ */
+export type SurveyDomainPayload = Record<string, unknown>;
+
+export interface SurveyResponseDTO {
+  comment_mode?: string | null;
+  created_at?: string | null;
+  delivery_channel: string;
+  id: string;
+  is_active: boolean;
+  name: string;
+  question_text: string;
+  scale_max: number;
+  scale_min: number;
+  score_field_column_id?: string | null;
+  template_id?: number | null;
+  thank_you_copy?: string | null;
+  type: string;
+}
+
+export interface SurveyResponseRowDTO {
+  channel?: string | null;
+  classification?: string | null;
+  comment?: string | null;
+  contact_id: number;
+  first_name?: string | null;
+  history?: Array<SurveyScorePointDTO>;
+  last_name?: string | null;
+  responded_at?: string | null;
+  response_count?: number;
+  score: number;
+  trend?: string | null;
+}
+
+export interface SurveyResponsesDTO {
+  responses: Array<SurveyResponseRowDTO>;
+  survey_id: string;
+}
+
+export interface SurveyScorePointDTO {
+  responded_at?: string | null;
+  score: number;
+  send_id?: number | null;
+}
+
+/** A send that has been accepted for dispatch, not yet delivered. */
+export interface SurveySendAccepted {
+  /** Contacts resolved from the audience at accept time. */
+  recipient_count: number;
+  /** Poll GET /surveys/sends/{send_id} for progress. */
+  send_id: number;
+  /** Dispatch state, e.g. queued or scheduled. */
+  status: string;
+}
+
+export interface SurveySendDTO {
+  audience_ref?: string | null;
+  channel: string;
+  id: number;
+  recipient_count: number;
+  scheduled_at?: string | null;
+  status: string;
+  survey_id: string;
+}
+
+export interface SurveySendRowDTO {
+  audience_name?: string | null;
+  audience_ref?: string | null;
+  channel: string;
+  created_at?: string | null;
+  delivery_breakdown: SendDeliveryBreakdownDTO;
+  id: number;
+  recipient_count?: number;
+  responded_count?: number;
+  scheduled_at?: string | null;
+  status: string;
+  trigger_kind?: string | null;
+}
+
+export interface SurveySendingDomainDTO {
+  domain: string;
+  id: number;
+  status: "verified" | "pending" | "not_set_up";
+}
+
+export interface SurveySendsDTO {
+  sends: Array<SurveySendRowDTO>;
+  survey_id: string;
+}
+
+export interface SurveyTriggerDTO {
+  audience_ref?: string | null;
+  cadence_days?: number | null;
+  id: string;
+  is_active: boolean;
+  reply_to?: string | null;
+  sender_email: string;
+  sender_name?: string | null;
+  stage_value?: string | null;
+  subject: string;
+  survey_id: string;
+  trigger_kind: string;
+}
+
+export interface SurveyTriggerDeleteResponse {
+  deleted: boolean;
+  survey_id?: string | null;
+  trigger_id: string;
+}
+
+export interface TrendBarDTO {
+  csat_avg?: number | null;
+  detractors: number;
+  nps_score?: number | null;
+  passives: number;
+  period: string;
+  promoters: number;
+  total: number;
+}
+
+export interface TrendsDTO {
+  bars: Array<TrendBarDTO>;
+  bucket: string;
+  delivery_channel: string;
+  survey_id: string;
+  type: string;
+}
+
+export interface UpdateSurveyRequest {
+  delivery_channel?: string | null;
+  is_active?: boolean | null;
+  name?: string | null;
+  question_text?: string | null;
+  template_id?: number | null;
+  thank_you_copy?: string | null;
+}
+
+/** Start verification of a survey sending domain. */
+export interface VerifySurveyDomainRequest {
+  /** The sending domain or subdomain, e.g. `feedback.acme.com`. */
+  domain: string;
+}