@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/sequenceLifecycle.md

@@ -0,0 +1,513 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.sequenceLifecycle`: Sequence Lifecycle
+
+8 operations (3 read, 2 destructive, 3 external).
+
+6 of these also have a hand-written method (`g8.sequences`), marked **★** below. Prefer the hand-written method when one exists: it unwraps the `data` envelope and takes friendlier arguments. See [../sdk-clients.md](../sdk-clients.md).
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [sequenceLifecycle.d.ts](sequenceLifecycle.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`createSequence`](#op-createsequence) ★ | `POST /api/v1/sequences` | external | `sequences:run` | Create Sequence |
+| [`deleteSequence`](#op-deletesequence) ★ | `DELETE /api/v1/sequences/{sequence_id}` | destructive | `sequences:delete` | Delete Sequence |
+| [`getSequenceAnalytics`](#op-getsequenceanalytics) ★ | `GET /api/v1/sequences/{sequence_id}/analytics` | read | `sequences:read` | Get Sequence Analytics |
+| [`listSequenceSteps`](#op-listsequencesteps) | `GET /api/v1/sequences/{sequence_id}/steps` | read | `sequences:read` | List Sequence Steps |
+| [`previewSequence`](#op-previewsequence) ★ | `GET /api/v1/sequences/{sequence_id}/preview` | read | `sequences:read` | Preview Sequence |
+| [`removeLinkedinChannel`](#op-removelinkedinchannel) | `DELETE /api/v1/sequences/{sequence_id}/channels/linkedin` | destructive | `sequences:delete` | Remove Linkedin Channel |
+| [`updateSequence`](#op-updatesequence) ★ | `PATCH /api/v1/sequences/{sequence_id}` | external | `sequences:run` | Update Sequence |
+| [`updateSequenceStep`](#op-updatesequencestep) ★ | `PATCH /api/v1/sequences/{sequence_id}/steps/{step_id}` | external | `sequences:run` | Update Sequence Step |
+
+---
+
+<a id="op-createsequence"></a>
+
+### `g8.api.sequenceLifecycle.createSequence(input)`
+
+**Create Sequence**
+
+- HTTP: `POST /api/v1/sequences`
+- operationId: `create_sequence_sequences_post` (also callable as `g8.api.call("create_sequence_sequences_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `sequences:run`
+- ★ Hand-written: [`g8.sequences.create()`](../sdk-clients.md#g8-sequences-create)
+
+Create a new sequence with optional steps and channels.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `SequenceCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`SequenceCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | Sequence name |
+| `body.associated_list_id` | `integer \| null` | no | Contact list to associate |
+| `body.campaign_id` | `string \| null` | no | AI Studio campaign to link |
+| `body.channels` | `Array<ChannelConfig> \| null` | no | Channels to attach |
+| `body.description` | `string \| null` | no | Sequence description |
+| `body.finish_on_reply` | `boolean` | no | Stop contacting on reply default `true` |
+| `body.pinned_mailbox_id` | `integer \| null` | no | Mailbox ID to pin for a nurture sequence. Required when sequence_kind='nurture'; all email channels must use this mailbox. Ignored for cold_outbound sequences. |
+| `body.send_in_same_thread` | `boolean` | no | Send follow-ups in same email thread default `false` |
+| `body.sequence_kind` | `string \| null` | no | Sequence kind: 'cold_outbound' (default) or 'nurture'. Immutable after creation. 'nurture' requires pinned_mailbox_id and is gated by the ENABLE_NURTURE feature flag. default `"cold_outbound"` |
+| `body.steps` | `Array<StepConfig> \| null` | no | Sequence steps to create |
+| `body.user_email` | `string \| null` | no | Owner email address. Omit it to make the person who minted this API key the owner (org keys that record no creator must still send it). |
+| `body.wait_for_new_contacts` | `boolean` | no | Keep sequence waiting for new contacts default `false` |
+
+**Returns** `ApiResponse_SequenceCreateResponse_`: the envelope `{ data: SequenceCreateResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceCreateResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `name` | `string` | yes |  |
+| `status` | `string` | yes |  |
+| `created_at` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.sequenceLifecycle.createSequence({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-deletesequence"></a>
+
+### `g8.api.sequenceLifecycle.deleteSequence(input)`
+
+**Delete Sequence**
+
+- HTTP: `DELETE /api/v1/sequences/{sequence_id}`
+- operationId: `delete_sequence_sequences__sequence_id__delete` (also callable as `g8.api.call("delete_sequence_sequences__sequence_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `sequences:delete`
+- ★ Hand-written: [`g8.sequences.delete()`](../sdk-clients.md#g8-sequences-delete)
+
+Soft-delete (archive) a sequence. Sets is_archived=True.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+
+**Returns** `ApiResponse_SequenceActionResponse_`: the envelope `{ data: SequenceActionResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceActionResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `status` | `string` | yes |  |
+| `contacts_affected` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.sequenceLifecycle.deleteSequence({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-getsequenceanalytics"></a>
+
+### `g8.api.sequenceLifecycle.getSequenceAnalytics(input)`
+
+**Get Sequence Analytics**
+
+- HTTP: `GET /api/v1/sequences/{sequence_id}/analytics`
+- operationId: `get_sequence_analytics_sequences__sequence_id__analytics_get` (also callable as `g8.api.call("get_sequence_analytics_sequences__sequence_id__analytics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `sequences:read`
+- ★ Hand-written: [`g8.sequences.analytics()`](../sdk-clients.md#g8-sequences-analytics)
+
+Get comprehensive analytics for a sequence.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+
+**Returns** `ApiResponse_SequenceAnalyticsResponse_`: the envelope `{ data: SequenceAnalyticsResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceAnalyticsResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `contact_distribution` | `Record<string, unknown>` | no |  |
+| `engagement` | `Record<string, unknown>` | no |  |
+| `overview` | `Record<string, unknown>` | no |  |
+| `performance` | `Record<string, unknown>` | no |  |
+| `sender_distribution` | `Array<Record<string, unknown>>` | no |  |
+| `step_breakdown` | `Array<Record<string, unknown>>` | no |  |
+| `step_creation_methods` | `Array<Record<string, unknown>>` | no |  |
+| `timeline` | `Array<Record<string, unknown>>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.sequenceLifecycle.getSequenceAnalytics({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-listsequencesteps"></a>
+
+### `g8.api.sequenceLifecycle.listSequenceSteps(input)`
+
+**List Sequence Steps**
+
+- HTTP: `GET /api/v1/sequences/{sequence_id}/steps`
+- operationId: `list_sequence_steps_sequences__sequence_id__steps_get` (also callable as `g8.api.call("list_sequence_steps_sequences__sequence_id__steps_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `sequences:read`
+
+List a sequence's steps with their resolved copy. Read-only, no enrollment.
+
+The step list from ``/preview`` without the sequence and channel envelope. Each
+step carries the same ``rendered`` block described on ``/preview``, so this is
+the direct way to check what a given step will actually send.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+
+**Returns** `ApiResponse_SequenceStepsResponse_`: the envelope `{ data: SequenceStepsResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceStepsResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `steps` | `Array<PreviewStepItem>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.sequenceLifecycle.listSequenceSteps({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-previewsequence"></a>
+
+### `g8.api.sequenceLifecycle.previewSequence(input)`
+
+**Preview Sequence**
+
+- HTTP: `GET /api/v1/sequences/{sequence_id}/preview`
+- operationId: `preview_sequence_sequences__sequence_id__preview_get` (also callable as `g8.api.call("preview_sequence_sequences__sequence_id__preview_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `sequences:read`
+- ★ Hand-written: [`g8.sequences.preview()`](../sdk-clients.md#g8-sequences-preview)
+
+Load a sequence with its steps and channels, including RESOLVED copy. No enrollment.
+
+Each step carries both:
+
+- ``step_data``: the stored template, exactly as written, spintax braces and all.
+- ``rendered``: the same copy with spintax collapsed to one real variant, plus
+  ``total_combinations`` and up to three sample ``variants``.
+
+Use ``rendered`` to answer "is my spintax working?". If ``variants`` differ from
+each other, per-contact variation is live and each lead gets a different email.
+``{{variables}}`` stay visible in ``rendered`` on purpose; they fill in at send
+time from contact data, and a preview has no contact to fill them from.
+
+``rendered`` is null for ON_DEMAND steps, whose copy the AI writes per contact
+at send time rather than reading from ``step_data``.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+
+**Returns** `ApiResponse_SequencePreviewResponse_`: the envelope `{ data: SequencePreviewResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequencePreviewResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `channels` | `Array<PreviewChannelItem>` | no |  |
+| `description` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `steps` | `Array<PreviewStepItem>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.sequenceLifecycle.previewSequence({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-removelinkedinchannel"></a>
+
+### `g8.api.sequenceLifecycle.removeLinkedinChannel(input)`
+
+**Remove Linkedin Channel**
+
+- HTTP: `DELETE /api/v1/sequences/{sequence_id}/channels/linkedin`
+- operationId: `remove_linkedin_channel_sequences__sequence_id__channels_linkedin_delete` (also callable as `g8.api.call("remove_linkedin_channel_sequences__sequence_id__channels_linkedin_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `sequences:delete`
+
+Remove this sequence's LinkedIn steps AND its LinkedIn channel, atomically.
+
+Unbinding the channel on its own leaves the LinkedIn steps with no sender,
+which makes the sequence impossible to run or resume (400, and the sequence is
+reverted to DRAFTED) and pauses it outright if a contact reaches the step. This
+endpoint removes both halves in one transaction so that state is never created.
+
+A sequence with no LinkedIn binding returns 200 with zero counts rather than
+404, so it is safe to call across a batch. It also cleans up sequences already
+stranded with orphaned LinkedIn steps.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+| `query.dry_run` | `boolean` | no | Preview exactly what would be removed without writing anything. default `false` |
+| `query.force` | `boolean` | no | Required to operate on a LIVE or WAITING sequence. The sequence is paused afterwards either way so the result can be reviewed before it resumes sending. default `false` |
+
+**Returns** `ApiResponse_LinkedInChannelRemovalResponse_`: the envelope `{ data: LinkedInChannelRemovalResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`LinkedInChannelRemovalResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `auto_paused` | `boolean` | yes | True when a LIVE/WAITING sequence was paused as part of this operation |
+| `channels_removed` | `integer` | yes | Number of LinkedIn channel bindings removed |
+| `dry_run` | `boolean` | yes | True when nothing was written |
+| `remaining_channel_count` | `integer` | yes | Live channel bindings left afterwards |
+| `remaining_step_count` | `integer` | yes | Steps left on the sequence afterwards |
+| `sequence_id` | `string` | yes | Sequence that was operated on |
+| `sequence_now_empty` | `boolean` | yes | True when the sequence has no steps left |
+| `status_after` | `string` | yes | Sequence status after the operation |
+| `status_before` | `string` | yes | Sequence status before the operation |
+| `steps_removed` | `integer` | yes | Number of LinkedIn steps deleted |
+| `channel_type_removed` | `string \| null` | no | Persisted channel_type that was unbound, e.g. LINKEDIN_NETRION |
+| `provider` | `string \| null` | no | LinkedIn provider detected: NETRION, HEYREACH, or null when none was bound |
+| `removed_steps` | `Array<RemovedStepSummary>` | no | The steps that were (or would be) removed |
+| `warnings` | `Array<string>` | no | Advisory notes the caller should surface to the user |
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.sequenceLifecycle.removeLinkedinChannel({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-updatesequence"></a>
+
+### `g8.api.sequenceLifecycle.updateSequence(input)`
+
+**Update Sequence**
+
+- HTTP: `PATCH /api/v1/sequences/{sequence_id}`
+- operationId: `update_sequence_sequences__sequence_id__patch` (also callable as `g8.api.call("update_sequence_sequences__sequence_id__patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `sequences:run`
+- ★ Hand-written: [`g8.sequences.update()`](../sdk-clients.md#g8-sequences-update)
+
+Update sequence metadata. Rejects PATCH when status is transitional (409).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+| `body` | `SequenceUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`SequenceUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.appointment_id` | `integer \| null` | no | Calendar event-type ID (from GET /event-types). Stamped onto seqsequences.appointment_id. |
+| `body.description` | `string \| null` | no | Sequence description |
+| `body.finish_on_reply` | `boolean \| null` | no | Finish on reply |
+| `body.is_shared` | `boolean \| null` | no | Whether sequence is shared |
+| `body.name` | `string \| null` | no | Sequence name |
+| `body.schedule_id` | `string \| null` | no | Send-window schedule UUID (from GET /schedules). Stamped onto seqsequences.schedule_id. |
+| `body.send_in_same_thread` | `boolean \| null` | no | Send in same thread |
+| `body.textual_agent_name` | `string \| null` | no | Voice-service agent identifier (from GET /voice/dialer/agents) for email / social steps. Stamped onto seqsequences.textual_agent_name. The same value as voice_agent_name is the common case (one agent across channels). |
+| `body.voice_agent_name` | `string \| null` | no | Voice-service agent identifier (from GET /voice/dialer/agents) for phone / SMS steps. Stamped onto seqsequences.voice_agent_name. |
+| `body.wait_for_new_contacts` | `boolean \| null` | no | Wait for new contacts |
+
+**Returns** `ApiResponse_SequenceActionResponse_`: the envelope `{ data: SequenceActionResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceActionResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `status` | `string` | yes |  |
+| `contacts_affected` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.sequenceLifecycle.updateSequence({ path: { sequence_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updatesequencestep"></a>
+
+### `g8.api.sequenceLifecycle.updateSequenceStep(input)`
+
+**Update Sequence Step**
+
+- HTTP: `PATCH /api/v1/sequences/{sequence_id}/steps/{step_id}`
+- operationId: `update_sequence_step_sequences__sequence_id__steps__step_id__patch` (also callable as `g8.api.call("update_sequence_step_sequences__sequence_id__steps__step_id__patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `sequences:run`
+- ★ Hand-written: [`g8.sequences.updateStep()`](../sdk-clients.md#g8-sequences-updatestep)
+
+Update a single step within a sequence.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | Sequence ID |
+| `path.step_id` | `string` | yes | Step ID |
+| `body` | `StepUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`StepUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.input_type` | `string \| null` | no | Input type. One of: ON_DEMAND, MANUAL_TEMPLATE, AI_GENERATED_TEMPLATE. Case-insensitive. |
+| `body.step_data` | `Record<string, unknown> \| null` | no | Step template/content data |
+| `body.step_type` | `string \| null` | no | Step type. One of: EMAIL, PHONE, SMS, WHATSAPP, HEYREACH, MANUAL_DIALER. Case-insensitive. |
+| `body.time_interval` | `integer \| null` | no | Delay in seconds after the previous step |
+
+**Returns** `ApiResponse_SequenceActionResponse_`: the envelope `{ data: SequenceActionResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`SequenceActionResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `status` | `string` | yes |  |
+| `contacts_affected` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.sequenceLifecycle.updateSequenceStep({ path: { sequence_id: "id", step_id: "id" }, body: {} });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-channelconfig"></a>
+
+### `ChannelConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `channel_id` | `integer` | yes | Channel resource ID (mailbox ID, phone ID, etc.) |
+| `channel_type` | `string` | yes | Channel type. One of: SMTP, GMAIL, INBOXKIT, PHONE, LINKEDIN, SMS, WHATSAPP. Case-insensitive. |
+| `channel_value` | `string` | yes | Channel value (email address, phone number, etc.) |
+| `channel_data` | `Record<string, unknown> \| null` | no | Extra channel metadata |
+
+<a id="type-previewchannelitem"></a>
+
+### `PreviewChannelItem`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `channel_id` | `integer \| null` | no |  |
+| `channel_type` | `string \| null` | no |  |
+| `channel_value` | `string \| null` | no |  |
+
+<a id="type-previewstepitem"></a>
+
+### `PreviewStepItem`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes |  |
+| `input_type` | `string` | yes |  |
+| `step_order` | `integer` | yes |  |
+| `step_type` | `string` | yes |  |
+| `rendered` | `RenderedStepContent \| null` | no | Spintax-resolved view of this step's copy. Populated for template steps that carry subject/body. Null for ON_DEMAND steps, whose copy is written by the AI at send time rather than stored here. |
+| `step_data` | `Record<string, unknown> \| null` | no |  |
+| `time_interval` | `integer \| null` | no |  |
+
+<a id="type-removedstepsummary"></a>
+
+### `RemovedStepSummary`
+
+One step removed by the LinkedIn-removal operation.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes | Step ID that was removed |
+| `step_order` | `integer` | yes | Position the step held before removal |
+| `step_type` | `string` | yes | Persisted step type, e.g. NETRION or HEYREACH |
+
+<a id="type-stepconfig"></a>
+
+### `StepConfig`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `step_order` | `integer` | yes | Order of the step in the sequence (1-based) |
+| `step_type` | `string` | yes | Step type. One of: EMAIL, PHONE, SMS, WHATSAPP, HEYREACH, MANUAL_DIALER. Note: LinkedIn outreach uses HEYREACH (not LINKEDIN). Case-insensitive aliases accepted. |
+| `input_type` | `string` | no | Input type. One of: ON_DEMAND, MANUAL_TEMPLATE, AI_GENERATED_TEMPLATE. Case-insensitive aliases accepted (e.g. 'template' -> MANUAL_TEMPLATE, 'ai' -> AI_GENERATED_TEMPLATE). default `"ON_DEMAND"` |
+| `step_data` | `Record<string, unknown> \| null` | no | Step template/content data (subject, body, instructions, etc.) |
+| `time_interval` | `integer` | no | Delay in seconds after the previous step default `0` |