@rippling/rippling-sdk 0.2.0-alpha.95 → 0.2.0-alpha.97

package/src/resources/workflows.ts

@@ -0,0 +1,1434 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Execute workflow actions like sending emails, Slack messages, and notifications
+ */
+export class Workflows extends APIResource {
+  /**
+   * List workflows
+   */
+  list(
+    query: WorkflowListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<WorkflowListResponsesPageCursorURL, WorkflowListResponse> {
+    return this._client.getAPIList('/workflows/', PageCursorURL<WorkflowListResponse>, { query, ...options });
+  }
+
+  /**
+   * Create a workflow
+   */
+  create(body: WorkflowCreateParams, options?: RequestOptions): APIPromise<WorkflowCreateResponse> {
+    return this._client.post('/workflows/', { body, ...options });
+  }
+
+  /**
+   * Retrieve a workflow
+   */
+  retrieve(
+    id: string,
+    query: WorkflowRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<WorkflowRetrieveResponse> {
+    return this._client.get(path`/workflows/${id}/`, { query, ...options });
+  }
+
+  /**
+   * Update a workflow
+   */
+  update(
+    id: string,
+    body: WorkflowUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkflowUpdateResponse> {
+    return this._client.patch(path`/workflows/${id}/`, { body, ...options });
+  }
+
+  /**
+   * Delete a workflow
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/workflows/${id}/`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type WorkflowListResponsesPageCursorURL = PageCursorURL<WorkflowListResponse>;
+
+export interface WorkflowListResponse {
+  id: string;
+
+  created_at: string;
+
+  description: string | null;
+
+  enabled: boolean;
+
+  has_draft: boolean;
+
+  name: string;
+
+  owner_id: string;
+
+  status: 'draft' | 'published' | 'unknown';
+
+  updated_at: string;
+
+  version_id: string;
+}
+
+export interface WorkflowCreateResponse {
+  id: string;
+
+  authoring: WorkflowCreateResponse.Authoring;
+
+  created_at: string;
+
+  definition:
+    | WorkflowCreateResponse.EditableWorkflowDefinition
+    | WorkflowCreateResponse.ReadOnlyWorkflowDefinition;
+
+  deletable: boolean;
+
+  enabled: boolean;
+
+  has_draft: boolean;
+
+  name: string;
+
+  owner_id: string;
+
+  status: 'draft' | 'published' | 'unknown';
+
+  updated_at: string;
+
+  version_id: string;
+
+  description?: string | null;
+}
+
+export namespace WorkflowCreateResponse {
+  export interface Authoring {
+    mode: 'full' | 'metadata_only' | 'read_only';
+
+    patchable_fields: Array<'name' | 'description' | 'status' | 'enabled' | 'trigger' | 'actions'>;
+
+    reason_codes: Array<
+      'unsupported_trigger' | 'unsupported_graph' | 'insufficient_permission' | 'missing_current_version'
+    >;
+  }
+
+  export interface EditableWorkflowDefinition {
+    actions: Array<EditableWorkflowDefinition.Action>;
+
+    kind: 'editable';
+
+    trigger:
+      | EditableWorkflowDefinition.DailyScheduleTrigger
+      | EditableWorkflowDefinition.BusinessEventTrigger
+      | EditableWorkflowDefinition.WeekdayScheduleTrigger
+      | EditableWorkflowDefinition.WeeklyScheduleTrigger
+      | EditableWorkflowDefinition.BiweeklyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyOnDayOfWeekScheduleTrigger
+      | EditableWorkflowDefinition.QuarterlyScheduleTrigger
+      | EditableWorkflowDefinition.AnnualScheduleTrigger
+      | EditableWorkflowDefinition.OneTimeScheduleTrigger
+      | EditableWorkflowDefinition.CustomScheduleTrigger
+      | EditableWorkflowDefinition.CronScheduleTrigger
+      | EditableWorkflowDefinition.SlackTrigger
+      | EditableWorkflowDefinition.InboundEmailTrigger;
+  }
+
+  export namespace EditableWorkflowDefinition {
+    export interface Action {
+      id: string;
+
+      implementation_config: string;
+
+      kind: 'registered_callback';
+
+      owner_id: string;
+
+      owner_type: string;
+    }
+
+    export interface DailyScheduleTrigger {
+      hour: number;
+
+      kind: 'daily_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BusinessEventTrigger {
+      event_name: string;
+
+      kind: 'business_event';
+    }
+
+    export interface WeekdayScheduleTrigger {
+      hour: number;
+
+      kind: 'weekday_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface WeeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'weekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BiweeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'biweekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'monthly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyOnDayOfWeekScheduleTrigger {
+      day_of_week: number;
+
+      hour: number;
+
+      kind: 'monthly_on_day_of_week_schedule';
+
+      timezone: string;
+
+      week_of_month: number;
+
+      minute?: number;
+    }
+
+    export interface QuarterlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'quarterly_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface AnnualScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'annual_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface OneTimeScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'one_time_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      year: number;
+
+      minute?: number;
+    }
+
+    export interface CustomScheduleTrigger {
+      interval: number;
+
+      kind: 'custom_schedule';
+
+      timezone: string;
+
+      unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+
+      day_of_month?: number | null;
+
+      days_of_week?: Array<number> | null;
+
+      hour?: number;
+
+      minute?: number;
+
+      month_of_year?: number | null;
+
+      start_month?: number | null;
+    }
+
+    export interface CronScheduleTrigger {
+      expression: string;
+
+      kind: 'cron_schedule';
+
+      timezone: string;
+    }
+
+    export interface SlackTrigger {
+      channel_ids: Array<string>;
+
+      event_type: 'message_posted' | 'reaction_added';
+
+      kind: 'slack';
+
+      allowed_sender_group_id?: string | null;
+
+      include_thread_replies?: boolean;
+
+      message_text_regex?: string | null;
+
+      reaction_names?: Array<string>;
+    }
+
+    export interface InboundEmailTrigger {
+      kind: 'inbound_email';
+
+      recipient_email: string;
+
+      body_contains?: string | null;
+
+      has_attachment?: boolean;
+
+      subject_contains?: string | null;
+    }
+  }
+
+  export interface ReadOnlyWorkflowDefinition {
+    kind: 'read_only';
+
+    steps: Array<ReadOnlyWorkflowDefinition.Step>;
+
+    trigger: ReadOnlyWorkflowDefinition.Trigger;
+  }
+
+  export namespace ReadOnlyWorkflowDefinition {
+    export interface Step {
+      id: string;
+
+      kind: 'read_only';
+
+      name: string;
+
+      next_ids: Array<string>;
+
+      source_type: 'action' | 'fork' | 'loop' | 'switch' | 'group' | 'unknown';
+    }
+
+    export interface Trigger {
+      kind: 'read_only';
+
+      source_type:
+        | 'business_event'
+        | 'record_change'
+        | 'scheduled'
+        | 'manual'
+        | 'webhook'
+        | 'date_relative'
+        | 'integration'
+        | 'unknown';
+
+      summary: string;
+    }
+  }
+}
+
+export interface WorkflowRetrieveResponse {
+  id: string;
+
+  authoring: WorkflowRetrieveResponse.Authoring;
+
+  created_at: string;
+
+  definition:
+    | WorkflowRetrieveResponse.EditableWorkflowDefinition
+    | WorkflowRetrieveResponse.ReadOnlyWorkflowDefinition;
+
+  deletable: boolean;
+
+  enabled: boolean;
+
+  has_draft: boolean;
+
+  name: string;
+
+  owner_id: string;
+
+  status: 'draft' | 'published' | 'unknown';
+
+  updated_at: string;
+
+  version_id: string;
+
+  description?: string | null;
+}
+
+export namespace WorkflowRetrieveResponse {
+  export interface Authoring {
+    mode: 'full' | 'metadata_only' | 'read_only';
+
+    patchable_fields: Array<'name' | 'description' | 'status' | 'enabled' | 'trigger' | 'actions'>;
+
+    reason_codes: Array<
+      'unsupported_trigger' | 'unsupported_graph' | 'insufficient_permission' | 'missing_current_version'
+    >;
+  }
+
+  export interface EditableWorkflowDefinition {
+    actions: Array<EditableWorkflowDefinition.Action>;
+
+    kind: 'editable';
+
+    trigger:
+      | EditableWorkflowDefinition.DailyScheduleTrigger
+      | EditableWorkflowDefinition.BusinessEventTrigger
+      | EditableWorkflowDefinition.WeekdayScheduleTrigger
+      | EditableWorkflowDefinition.WeeklyScheduleTrigger
+      | EditableWorkflowDefinition.BiweeklyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyOnDayOfWeekScheduleTrigger
+      | EditableWorkflowDefinition.QuarterlyScheduleTrigger
+      | EditableWorkflowDefinition.AnnualScheduleTrigger
+      | EditableWorkflowDefinition.OneTimeScheduleTrigger
+      | EditableWorkflowDefinition.CustomScheduleTrigger
+      | EditableWorkflowDefinition.CronScheduleTrigger
+      | EditableWorkflowDefinition.SlackTrigger
+      | EditableWorkflowDefinition.InboundEmailTrigger;
+  }
+
+  export namespace EditableWorkflowDefinition {
+    export interface Action {
+      id: string;
+
+      implementation_config: string;
+
+      kind: 'registered_callback';
+
+      owner_id: string;
+
+      owner_type: string;
+    }
+
+    export interface DailyScheduleTrigger {
+      hour: number;
+
+      kind: 'daily_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BusinessEventTrigger {
+      event_name: string;
+
+      kind: 'business_event';
+    }
+
+    export interface WeekdayScheduleTrigger {
+      hour: number;
+
+      kind: 'weekday_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface WeeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'weekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BiweeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'biweekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'monthly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyOnDayOfWeekScheduleTrigger {
+      day_of_week: number;
+
+      hour: number;
+
+      kind: 'monthly_on_day_of_week_schedule';
+
+      timezone: string;
+
+      week_of_month: number;
+
+      minute?: number;
+    }
+
+    export interface QuarterlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'quarterly_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface AnnualScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'annual_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface OneTimeScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'one_time_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      year: number;
+
+      minute?: number;
+    }
+
+    export interface CustomScheduleTrigger {
+      interval: number;
+
+      kind: 'custom_schedule';
+
+      timezone: string;
+
+      unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+
+      day_of_month?: number | null;
+
+      days_of_week?: Array<number> | null;
+
+      hour?: number;
+
+      minute?: number;
+
+      month_of_year?: number | null;
+
+      start_month?: number | null;
+    }
+
+    export interface CronScheduleTrigger {
+      expression: string;
+
+      kind: 'cron_schedule';
+
+      timezone: string;
+    }
+
+    export interface SlackTrigger {
+      channel_ids: Array<string>;
+
+      event_type: 'message_posted' | 'reaction_added';
+
+      kind: 'slack';
+
+      allowed_sender_group_id?: string | null;
+
+      include_thread_replies?: boolean;
+
+      message_text_regex?: string | null;
+
+      reaction_names?: Array<string>;
+    }
+
+    export interface InboundEmailTrigger {
+      kind: 'inbound_email';
+
+      recipient_email: string;
+
+      body_contains?: string | null;
+
+      has_attachment?: boolean;
+
+      subject_contains?: string | null;
+    }
+  }
+
+  export interface ReadOnlyWorkflowDefinition {
+    kind: 'read_only';
+
+    steps: Array<ReadOnlyWorkflowDefinition.Step>;
+
+    trigger: ReadOnlyWorkflowDefinition.Trigger;
+  }
+
+  export namespace ReadOnlyWorkflowDefinition {
+    export interface Step {
+      id: string;
+
+      kind: 'read_only';
+
+      name: string;
+
+      next_ids: Array<string>;
+
+      source_type: 'action' | 'fork' | 'loop' | 'switch' | 'group' | 'unknown';
+    }
+
+    export interface Trigger {
+      kind: 'read_only';
+
+      source_type:
+        | 'business_event'
+        | 'record_change'
+        | 'scheduled'
+        | 'manual'
+        | 'webhook'
+        | 'date_relative'
+        | 'integration'
+        | 'unknown';
+
+      summary: string;
+    }
+  }
+}
+
+export interface WorkflowUpdateResponse {
+  id: string;
+
+  authoring: WorkflowUpdateResponse.Authoring;
+
+  created_at: string;
+
+  definition:
+    | WorkflowUpdateResponse.EditableWorkflowDefinition
+    | WorkflowUpdateResponse.ReadOnlyWorkflowDefinition;
+
+  deletable: boolean;
+
+  enabled: boolean;
+
+  has_draft: boolean;
+
+  name: string;
+
+  owner_id: string;
+
+  status: 'draft' | 'published' | 'unknown';
+
+  updated_at: string;
+
+  version_id: string;
+
+  description?: string | null;
+}
+
+export namespace WorkflowUpdateResponse {
+  export interface Authoring {
+    mode: 'full' | 'metadata_only' | 'read_only';
+
+    patchable_fields: Array<'name' | 'description' | 'status' | 'enabled' | 'trigger' | 'actions'>;
+
+    reason_codes: Array<
+      'unsupported_trigger' | 'unsupported_graph' | 'insufficient_permission' | 'missing_current_version'
+    >;
+  }
+
+  export interface EditableWorkflowDefinition {
+    actions: Array<EditableWorkflowDefinition.Action>;
+
+    kind: 'editable';
+
+    trigger:
+      | EditableWorkflowDefinition.DailyScheduleTrigger
+      | EditableWorkflowDefinition.BusinessEventTrigger
+      | EditableWorkflowDefinition.WeekdayScheduleTrigger
+      | EditableWorkflowDefinition.WeeklyScheduleTrigger
+      | EditableWorkflowDefinition.BiweeklyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyScheduleTrigger
+      | EditableWorkflowDefinition.MonthlyOnDayOfWeekScheduleTrigger
+      | EditableWorkflowDefinition.QuarterlyScheduleTrigger
+      | EditableWorkflowDefinition.AnnualScheduleTrigger
+      | EditableWorkflowDefinition.OneTimeScheduleTrigger
+      | EditableWorkflowDefinition.CustomScheduleTrigger
+      | EditableWorkflowDefinition.CronScheduleTrigger
+      | EditableWorkflowDefinition.SlackTrigger
+      | EditableWorkflowDefinition.InboundEmailTrigger;
+  }
+
+  export namespace EditableWorkflowDefinition {
+    export interface Action {
+      id: string;
+
+      implementation_config: string;
+
+      kind: 'registered_callback';
+
+      owner_id: string;
+
+      owner_type: string;
+    }
+
+    export interface DailyScheduleTrigger {
+      hour: number;
+
+      kind: 'daily_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BusinessEventTrigger {
+      event_name: string;
+
+      kind: 'business_event';
+    }
+
+    export interface WeekdayScheduleTrigger {
+      hour: number;
+
+      kind: 'weekday_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface WeeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'weekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface BiweeklyScheduleTrigger {
+      days_of_week: Array<number>;
+
+      hour: number;
+
+      kind: 'biweekly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'monthly_schedule';
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface MonthlyOnDayOfWeekScheduleTrigger {
+      day_of_week: number;
+
+      hour: number;
+
+      kind: 'monthly_on_day_of_week_schedule';
+
+      timezone: string;
+
+      week_of_month: number;
+
+      minute?: number;
+    }
+
+    export interface QuarterlyScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'quarterly_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface AnnualScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'annual_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      minute?: number;
+    }
+
+    export interface OneTimeScheduleTrigger {
+      day_of_month: number;
+
+      hour: number;
+
+      kind: 'one_time_schedule';
+
+      month_of_year: number;
+
+      timezone: string;
+
+      year: number;
+
+      minute?: number;
+    }
+
+    export interface CustomScheduleTrigger {
+      interval: number;
+
+      kind: 'custom_schedule';
+
+      timezone: string;
+
+      unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+
+      day_of_month?: number | null;
+
+      days_of_week?: Array<number> | null;
+
+      hour?: number;
+
+      minute?: number;
+
+      month_of_year?: number | null;
+
+      start_month?: number | null;
+    }
+
+    export interface CronScheduleTrigger {
+      expression: string;
+
+      kind: 'cron_schedule';
+
+      timezone: string;
+    }
+
+    export interface SlackTrigger {
+      channel_ids: Array<string>;
+
+      event_type: 'message_posted' | 'reaction_added';
+
+      kind: 'slack';
+
+      allowed_sender_group_id?: string | null;
+
+      include_thread_replies?: boolean;
+
+      message_text_regex?: string | null;
+
+      reaction_names?: Array<string>;
+    }
+
+    export interface InboundEmailTrigger {
+      kind: 'inbound_email';
+
+      recipient_email: string;
+
+      body_contains?: string | null;
+
+      has_attachment?: boolean;
+
+      subject_contains?: string | null;
+    }
+  }
+
+  export interface ReadOnlyWorkflowDefinition {
+    kind: 'read_only';
+
+    steps: Array<ReadOnlyWorkflowDefinition.Step>;
+
+    trigger: ReadOnlyWorkflowDefinition.Trigger;
+  }
+
+  export namespace ReadOnlyWorkflowDefinition {
+    export interface Step {
+      id: string;
+
+      kind: 'read_only';
+
+      name: string;
+
+      next_ids: Array<string>;
+
+      source_type: 'action' | 'fork' | 'loop' | 'switch' | 'group' | 'unknown';
+    }
+
+    export interface Trigger {
+      kind: 'read_only';
+
+      source_type:
+        | 'business_event'
+        | 'record_change'
+        | 'scheduled'
+        | 'manual'
+        | 'webhook'
+        | 'date_relative'
+        | 'integration'
+        | 'unknown';
+
+      summary: string;
+    }
+  }
+}
+
+export interface WorkflowListParams {
+  cursor?: string;
+
+  limit?: number;
+}
+
+export interface WorkflowCreateParams {
+  actions: Array<WorkflowCreateParams.Action>;
+
+  name: string;
+
+  trigger:
+    | WorkflowCreateParams.DailyScheduleTrigger
+    | WorkflowCreateParams.BusinessEventTrigger
+    | WorkflowCreateParams.WeekdayScheduleTrigger
+    | WorkflowCreateParams.WeeklyScheduleTrigger
+    | WorkflowCreateParams.BiweeklyScheduleTrigger
+    | WorkflowCreateParams.MonthlyScheduleTrigger
+    | WorkflowCreateParams.MonthlyOnDayOfWeekScheduleTrigger
+    | WorkflowCreateParams.QuarterlyScheduleTrigger
+    | WorkflowCreateParams.AnnualScheduleTrigger
+    | WorkflowCreateParams.OneTimeScheduleTrigger
+    | WorkflowCreateParams.CustomScheduleTrigger
+    | WorkflowCreateParams.CronScheduleTrigger
+    | WorkflowCreateParams.SlackTrigger
+    | WorkflowCreateParams.InboundEmailTrigger;
+
+  description?: string | null;
+
+  enabled?: boolean;
+
+  status?: 'draft' | 'published';
+}
+
+export namespace WorkflowCreateParams {
+  export interface Action {
+    id: string;
+
+    implementation_config: string;
+
+    kind: 'registered_callback';
+
+    owner_id: string;
+
+    owner_type: string;
+  }
+
+  export interface DailyScheduleTrigger {
+    hour: number;
+
+    kind: 'daily_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface BusinessEventTrigger {
+    event_name: string;
+
+    kind: 'business_event';
+  }
+
+  export interface WeekdayScheduleTrigger {
+    hour: number;
+
+    kind: 'weekday_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface WeeklyScheduleTrigger {
+    days_of_week: Array<number>;
+
+    hour: number;
+
+    kind: 'weekly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface BiweeklyScheduleTrigger {
+    days_of_week: Array<number>;
+
+    hour: number;
+
+    kind: 'biweekly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface MonthlyScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'monthly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface MonthlyOnDayOfWeekScheduleTrigger {
+    day_of_week: number;
+
+    hour: number;
+
+    kind: 'monthly_on_day_of_week_schedule';
+
+    timezone: string;
+
+    week_of_month: number;
+
+    minute?: number;
+  }
+
+  export interface QuarterlyScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'quarterly_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface AnnualScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'annual_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface OneTimeScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'one_time_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    year: number;
+
+    minute?: number;
+  }
+
+  export interface CustomScheduleTrigger {
+    interval: number;
+
+    kind: 'custom_schedule';
+
+    timezone: string;
+
+    unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+
+    day_of_month?: number | null;
+
+    days_of_week?: Array<number> | null;
+
+    hour?: number;
+
+    minute?: number;
+
+    month_of_year?: number | null;
+
+    start_month?: number | null;
+  }
+
+  export interface CronScheduleTrigger {
+    expression: string;
+
+    kind: 'cron_schedule';
+
+    timezone: string;
+  }
+
+  export interface SlackTrigger {
+    channel_ids: Array<string>;
+
+    event_type: 'message_posted' | 'reaction_added';
+
+    kind: 'slack';
+
+    allowed_sender_group_id?: string | null;
+
+    include_thread_replies?: boolean;
+
+    message_text_regex?: string | null;
+
+    reaction_names?: Array<string>;
+  }
+
+  export interface InboundEmailTrigger {
+    kind: 'inbound_email';
+
+    recipient_email: string;
+
+    body_contains?: string | null;
+
+    has_attachment?: boolean;
+
+    subject_contains?: string | null;
+  }
+}
+
+export interface WorkflowRetrieveParams {
+  version_id?: string;
+}
+
+export interface WorkflowUpdateParams {
+  version_id: string;
+
+  actions?: Array<WorkflowUpdateParams.Action>;
+
+  description?: string | null;
+
+  enabled?: boolean;
+
+  name?: string;
+
+  status?: 'draft' | 'published';
+
+  trigger?:
+    | WorkflowUpdateParams.DailyScheduleTrigger
+    | WorkflowUpdateParams.BusinessEventTrigger
+    | WorkflowUpdateParams.WeekdayScheduleTrigger
+    | WorkflowUpdateParams.WeeklyScheduleTrigger
+    | WorkflowUpdateParams.BiweeklyScheduleTrigger
+    | WorkflowUpdateParams.MonthlyScheduleTrigger
+    | WorkflowUpdateParams.MonthlyOnDayOfWeekScheduleTrigger
+    | WorkflowUpdateParams.QuarterlyScheduleTrigger
+    | WorkflowUpdateParams.AnnualScheduleTrigger
+    | WorkflowUpdateParams.OneTimeScheduleTrigger
+    | WorkflowUpdateParams.CustomScheduleTrigger
+    | WorkflowUpdateParams.CronScheduleTrigger
+    | WorkflowUpdateParams.SlackTrigger
+    | WorkflowUpdateParams.InboundEmailTrigger;
+}
+
+export namespace WorkflowUpdateParams {
+  export interface Action {
+    id: string;
+
+    implementation_config: string;
+
+    kind: 'registered_callback';
+
+    owner_id: string;
+
+    owner_type: string;
+  }
+
+  export interface DailyScheduleTrigger {
+    hour: number;
+
+    kind: 'daily_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface BusinessEventTrigger {
+    event_name: string;
+
+    kind: 'business_event';
+  }
+
+  export interface WeekdayScheduleTrigger {
+    hour: number;
+
+    kind: 'weekday_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface WeeklyScheduleTrigger {
+    days_of_week: Array<number>;
+
+    hour: number;
+
+    kind: 'weekly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface BiweeklyScheduleTrigger {
+    days_of_week: Array<number>;
+
+    hour: number;
+
+    kind: 'biweekly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface MonthlyScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'monthly_schedule';
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface MonthlyOnDayOfWeekScheduleTrigger {
+    day_of_week: number;
+
+    hour: number;
+
+    kind: 'monthly_on_day_of_week_schedule';
+
+    timezone: string;
+
+    week_of_month: number;
+
+    minute?: number;
+  }
+
+  export interface QuarterlyScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'quarterly_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface AnnualScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'annual_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    minute?: number;
+  }
+
+  export interface OneTimeScheduleTrigger {
+    day_of_month: number;
+
+    hour: number;
+
+    kind: 'one_time_schedule';
+
+    month_of_year: number;
+
+    timezone: string;
+
+    year: number;
+
+    minute?: number;
+  }
+
+  export interface CustomScheduleTrigger {
+    interval: number;
+
+    kind: 'custom_schedule';
+
+    timezone: string;
+
+    unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+
+    day_of_month?: number | null;
+
+    days_of_week?: Array<number> | null;
+
+    hour?: number;
+
+    minute?: number;
+
+    month_of_year?: number | null;
+
+    start_month?: number | null;
+  }
+
+  export interface CronScheduleTrigger {
+    expression: string;
+
+    kind: 'cron_schedule';
+
+    timezone: string;
+  }
+
+  export interface SlackTrigger {
+    channel_ids: Array<string>;
+
+    event_type: 'message_posted' | 'reaction_added';
+
+    kind: 'slack';
+
+    allowed_sender_group_id?: string | null;
+
+    include_thread_replies?: boolean;
+
+    message_text_regex?: string | null;
+
+    reaction_names?: Array<string>;
+  }
+
+  export interface InboundEmailTrigger {
+    kind: 'inbound_email';
+
+    recipient_email: string;
+
+    body_contains?: string | null;
+
+    has_attachment?: boolean;
+
+    subject_contains?: string | null;
+  }
+}
+
+export declare namespace Workflows {
+  export {
+    type WorkflowListResponse as WorkflowListResponse,
+    type WorkflowCreateResponse as WorkflowCreateResponse,
+    type WorkflowRetrieveResponse as WorkflowRetrieveResponse,
+    type WorkflowUpdateResponse as WorkflowUpdateResponse,
+    type WorkflowListResponsesPageCursorURL as WorkflowListResponsesPageCursorURL,
+    type WorkflowListParams as WorkflowListParams,
+    type WorkflowCreateParams as WorkflowCreateParams,
+    type WorkflowRetrieveParams as WorkflowRetrieveParams,
+    type WorkflowUpdateParams as WorkflowUpdateParams,
+  };
+}