@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/linkedInOutreach.md

@@ -0,0 +1,990 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.linkedInOutreach`: LinkedIn Outreach
+
+20 operations (13 read, 7 external).
+
+No hand-written client covers this area. Call it through `g8.api.linkedInOutreach.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+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: [linkedInOutreach.d.ts](linkedInOutreach.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addOutreachListLeads`](#op-addoutreachlistleads) | `POST /api/v1/integrations/linkedin-outreach/lists/{list_id}/leads` | external | `integrations:run` | Add Outreach List Leads |
+| [`createOutreachList`](#op-createoutreachlist) | `POST /api/v1/integrations/linkedin-outreach/lists` | external | `integrations:run` | Create Outreach List |
+| [`getActiveOutreachWorkspace`](#op-getactiveoutreachworkspace) | `GET /api/v1/integrations/linkedin-outreach/workspaces/active` | read | `integrations:read` | Get Active Outreach Workspace |
+| [`getOutreachCampaignProgress`](#op-getoutreachcampaignprogress) | `GET /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/progress` | read | `integrations:read` | Get Outreach Campaign Progress |
+| [`getOutreachCampaignStats`](#op-getoutreachcampaignstats) | `GET /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/stats` | read | `integrations:read` | Get Outreach Campaign Stats |
+| [`getOutreachConnection`](#op-getoutreachconnection) | `GET /api/v1/integrations/linkedin-outreach/connection` | read | `integrations:read` | Get Outreach Connection |
+| [`getOutreachSequenceMapping`](#op-getoutreachsequencemapping) | `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/mapping` | read | `integrations:read` | Get Outreach Sequence Mapping |
+| [`getOutreachSequenceProgress`](#op-getoutreachsequenceprogress) | `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/progress` | read | `integrations:read` | Get Outreach Sequence Progress |
+| [`listOutreachCampaigns`](#op-listoutreachcampaigns) | `GET /api/v1/integrations/linkedin-outreach/campaigns` | read | `integrations:read` | List Outreach Campaigns |
+| [`listOutreachLists`](#op-listoutreachlists) | `GET /api/v1/integrations/linkedin-outreach/lists` | read | `integrations:read` | List Outreach Lists |
+| [`listOutreachSenderAccounts`](#op-listoutreachsenderaccounts) | `GET /api/v1/integrations/linkedin-outreach/accounts` | read | `integrations:read` | List Outreach Sender Accounts |
+| [`listOutreachSequenceStepCampaigns`](#op-listoutreachsequencestepcampaigns) | `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/step-campaigns` | read | `integrations:read` | List Outreach Sequence Step Campaigns |
+| [`listOutreachTemplates`](#op-listoutreachtemplates) | `GET /api/v1/integrations/linkedin-outreach/templates` | read | `integrations:read` | List Outreach Templates |
+| [`listOutreachWorkspaces`](#op-listoutreachworkspaces) | `GET /api/v1/integrations/linkedin-outreach/workspaces` | read | `integrations:read` | List Outreach Workspaces |
+| [`pauseOutreachCampaign`](#op-pauseoutreachcampaign) | `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/pause` | external | `integrations:run` | Pause Outreach Campaign |
+| [`reconnectOutreach`](#op-reconnectoutreach) | `POST /api/v1/integrations/linkedin-outreach/connection/reconnect` | external | `integrations:run` | Reconnect Outreach |
+| [`resumeOutreachCampaign`](#op-resumeoutreachcampaign) | `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/resume` | external | `integrations:run` | Resume Outreach Campaign |
+| [`searchOutreachCampaignLeads`](#op-searchoutreachcampaignleads) | `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/leads/search` | read | `integrations:read` | Search Outreach Campaign Leads |
+| [`selectActiveOutreachWorkspace`](#op-selectactiveoutreachworkspace) | `PUT /api/v1/integrations/linkedin-outreach/workspaces/active` | external | `integrations:run` | Select Active Outreach Workspace |
+| [`syncOutreachWorkspace`](#op-syncoutreachworkspace) | `POST /api/v1/integrations/linkedin-outreach/workspaces/sync` | external | `integrations:run` | Sync Outreach Workspace |
+
+---
+
+<a id="op-addoutreachlistleads"></a>
+
+### `g8.api.linkedInOutreach.addOutreachListLeads(input)`
+
+**Add Outreach List Leads**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/lists/{list_id}/leads`
+- operationId: `add_outreach_list_leads_integrations_linkedin_outreach_lists__list_id__leads_post` (also callable as `g8.api.call("add_outreach_list_leads_integrations_linkedin_outreach_lists__list_id__leads_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: `integrations:run`
+
+Add people to a lead list. REAL OUTREACH: any campaign running on this list starts contacting them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.list_id` | `integer` | yes | The outreach lead list's id. |
+| `body` | `OutreachAddLeadsRequest` | yes | Request body; fields below. |
+
+Body fields (`OutreachAddLeadsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.leads` | `Array<Record<string, unknown>>` | yes | min items 1 |
+
+**Returns** `ApiResponse_OutreachLeadsAdded_`: the envelope `{ data: OutreachLeadsAdded, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachLeadsAdded` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `added_count` | `integer` | yes |  |
+
+**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.linkedInOutreach.addOutreachListLeads({ path: { list_id: 123 }, body: { leads: [{}] } });
+```
+
+---
+
+<a id="op-createoutreachlist"></a>
+
+### `g8.api.linkedInOutreach.createOutreachList(input)`
+
+**Create Outreach List**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/lists`
+- operationId: `create_outreach_list_integrations_linkedin_outreach_lists_post` (also callable as `g8.api.call("create_outreach_list_integrations_linkedin_outreach_lists_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: `integrations:run`
+
+Create an empty lead list on the outreach platform.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `OutreachListCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`OutreachListCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1 |
+
+**Returns** `ApiResponse_OutreachListCreated_`: the envelope `{ data: OutreachListCreated, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachListCreated` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `name` | `string` | yes |  |
+
+**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.linkedInOutreach.createOutreachList({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-getactiveoutreachworkspace"></a>
+
+### `g8.api.linkedInOutreach.getActiveOutreachWorkspace(input?)`
+
+**Get Active Outreach Workspace**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/workspaces/active`
+- operationId: `get_active_outreach_workspace_integrations_linkedin_outreach_workspaces_active_get` (also callable as `g8.api.call("get_active_outreach_workspace_integrations_linkedin_outreach_workspaces_active_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+The workspace this org sends from, if one is selected.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachWorkspaceState_`: the envelope `{ data: OutreachWorkspaceState, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachWorkspaceState` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `connected` | `boolean \| null` | no |  |
+| `message` | `string \| null` | no |  |
+| `success` | `boolean \| null` | no |  |
+| `workspace_configured` | `boolean \| null` | no |  |
+| `workspace_id` | `integer \| null` | no |  |
+| `workspace_name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getActiveOutreachWorkspace();
+```
+
+---
+
+<a id="op-getoutreachcampaignprogress"></a>
+
+### `g8.api.linkedInOutreach.getOutreachCampaignProgress(input)`
+
+**Get Outreach Campaign Progress**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/progress`
+- operationId: `get_outreach_campaign_progress_integrations_linkedin_outreach_campaigns__campaign_id__progress_get` (also callable as `g8.api.call("get_outreach_campaign_progress_integrations_linkedin_outreach_campaigns__campaign_id__progress_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+How far through its leads a campaign is: pending, in progress, finished, failed, stopped, excluded.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.campaign_id` | `integer` | yes | The outreach campaign's id. |
+
+**Returns** `ApiResponse_OutreachCampaignProgress_`: the envelope `{ data: OutreachCampaignProgress, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignProgress` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `campaign_id` | `integer` | yes |  |
+| `campaign_name` | `string` | yes |  |
+| `progress_stats` | `OutreachProgressFigures` | yes |  |
+| `status` | `unknown` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getOutreachCampaignProgress({ path: { campaign_id: 123 } });
+```
+
+---
+
+<a id="op-getoutreachcampaignstats"></a>
+
+### `g8.api.linkedInOutreach.getOutreachCampaignStats(input)`
+
+**Get Outreach Campaign Stats**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/stats`
+- operationId: `get_outreach_campaign_stats_integrations_linkedin_outreach_campaigns__campaign_id__stats_get` (also callable as `g8.api.call("get_outreach_campaign_stats_integrations_linkedin_outreach_campaigns__campaign_id__stats_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Profile views, connection requests, messages, replies and their rates for one campaign.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.campaign_id` | `integer` | yes | The outreach campaign's id. |
+| `query.start_date` | `string \| null` | no | YYYY-MM-DD. Omit both dates for all time. |
+| `query.end_date` | `string \| null` | no | YYYY-MM-DD. |
+
+**Returns** `ApiResponse_OutreachCampaignStats_`: the envelope `{ data: OutreachCampaignStats, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignStats` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `stats` | `OutreachCampaignStatsFigures` | yes |  |
+| `by_day_stats` | `Record<string, unknown> \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getOutreachCampaignStats({ path: { campaign_id: 123 } });
+```
+
+---
+
+<a id="op-getoutreachconnection"></a>
+
+### `g8.api.linkedInOutreach.getOutreachConnection(input?)`
+
+**Get Outreach Connection**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/connection`
+- operationId: `get_outreach_connection_integrations_linkedin_outreach_connection_get` (also callable as `g8.api.call("get_outreach_connection_integrations_linkedin_outreach_connection_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Whether LinkedIn outreach is connected and its session healthy. Reports state, never credentials.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachConnectionStatus_`: the envelope `{ data: OutreachConnectionStatus, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachConnectionStatus` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `connected` | `boolean` | yes |  |
+| `auto_reauth_enabled` | `boolean` | no | default `false` |
+| `auto_reauth_error` | `string \| null` | no |  |
+| `auto_reauth_status` | `string \| null` | no |  |
+| `email` | `string \| null` | no |  |
+| `failed_reauth_count` | `integer \| null` | no |  |
+| `is_token_valid` | `boolean` | no | default `false` |
+| `last_reauth_success_at` | `string \| null` | no |  |
+| `reenable_in_seconds` | `integer \| null` | no |  |
+| `requires_manual_login` | `boolean \| null` | no |  |
+| `tenant_id` | `integer \| null` | no |  |
+| `time_until_expiry_seconds` | `integer \| null` | no |  |
+| `token_expires_at` | `string \| null` | no |  |
+| `workspace_configured` | `boolean` | no | default `false` |
+| `workspace_id` | `integer \| null` | no |  |
+| `workspace_name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getOutreachConnection();
+```
+
+---
+
+<a id="op-getoutreachsequencemapping"></a>
+
+### `g8.api.linkedInOutreach.getOutreachSequenceMapping(input)`
+
+**Get Outreach Sequence Mapping**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/mapping`
+- operationId: `get_outreach_sequence_mapping_integrations_linkedin_outreach_sequences__sequence_id__mapping_get` (also callable as `g8.api.call("get_outreach_sequence_mapping_integrations_linkedin_outreach_sequences__sequence_id__mapping_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+The outreach campaign and lead list a sequence runs through. 404 when it has none.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | The graph8 sequence's id. |
+
+**Returns** `ApiResponse_OutreachSequenceMapping_`: the envelope `{ data: OutreachSequenceMapping, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachSequenceMapping` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `campaign_id` | `integer \| null` | no |  |
+| `campaign_name` | `string \| null` | no |  |
+| `list_id` | `integer \| null` | no |  |
+| `status` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getOutreachSequenceMapping({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-getoutreachsequenceprogress"></a>
+
+### `g8.api.linkedInOutreach.getOutreachSequenceProgress(input)`
+
+**Get Outreach Sequence Progress**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/progress`
+- operationId: `get_outreach_sequence_progress_integrations_linkedin_outreach_sequences__sequence_id__progress_get` (also callable as `g8.api.call("get_outreach_sequence_progress_integrations_linkedin_outreach_sequences__sequence_id__progress_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Progress of the campaign a sequence runs through. 404 when the sequence has none.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | The graph8 sequence's id. |
+
+**Returns** `ApiResponse_OutreachCampaignProgress_`: the envelope `{ data: OutreachCampaignProgress, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignProgress` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `campaign_id` | `integer` | yes |  |
+| `campaign_name` | `string` | yes |  |
+| `progress_stats` | `OutreachProgressFigures` | yes |  |
+| `status` | `unknown` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.getOutreachSequenceProgress({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-listoutreachcampaigns"></a>
+
+### `g8.api.linkedInOutreach.listOutreachCampaigns(input?)`
+
+**List Outreach Campaigns**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/campaigns`
+- operationId: `list_outreach_campaigns_integrations_linkedin_outreach_campaigns_get` (also callable as `g8.api.call("list_outreach_campaigns_integrations_linkedin_outreach_campaigns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Outreach campaigns in the selected workspace.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.page` | `integer` | no | ZERO-indexed, passed through to the platform. default `0` |
+| `query.keyword` | `string` | no | Substring match on the campaign name. default `""` |
+
+**Returns** `ApiResponse_OutreachCampaigns_`: the envelope `{ data: OutreachCampaigns, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaigns` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `campaigns` | `Array<OutreachCampaign>` | yes |  |
+| `total_count` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachCampaigns();
+```
+
+---
+
+<a id="op-listoutreachlists"></a>
+
+### `g8.api.linkedInOutreach.listOutreachLists(input?)`
+
+**List Outreach Lists**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/lists`
+- operationId: `list_outreach_lists_integrations_linkedin_outreach_lists_get` (also callable as `g8.api.call("list_outreach_lists_integrations_linkedin_outreach_lists_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Lead lists on the outreach platform (not graph8 lists - those are `/lists`).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.page` | `integer` | no | ZERO-indexed, passed through to the platform. default `0` |
+| `query.search` | `string` | no | Substring match on the list name. default `""` |
+
+**Returns** `ApiResponse_OutreachLists_`: the envelope `{ data: OutreachLists, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachLists` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `lists` | `Array<OutreachList>` | yes |  |
+| `total_count` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachLists();
+```
+
+---
+
+<a id="op-listoutreachsenderaccounts"></a>
+
+### `g8.api.linkedInOutreach.listOutreachSenderAccounts(input?)`
+
+**List Outreach Sender Accounts**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/accounts`
+- operationId: `list_outreach_sender_accounts_integrations_linkedin_outreach_accounts_get` (also callable as `g8.api.call("list_outreach_sender_accounts_integrations_linkedin_outreach_accounts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+LinkedIn accounts that send outreach in the selected workspace.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachSenderAccounts_`: the envelope `{ data: OutreachSenderAccounts, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachSenderAccounts` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `accounts` | `Array<OutreachSenderAccount>` | yes |  |
+| `total_count` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachSenderAccounts();
+```
+
+---
+
+<a id="op-listoutreachsequencestepcampaigns"></a>
+
+### `g8.api.linkedInOutreach.listOutreachSequenceStepCampaigns(input)`
+
+**List Outreach Sequence Step Campaigns**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/sequences/{sequence_id}/step-campaigns`
+- operationId: `list_outreach_sequence_step_campaigns_integrations_linkedin_outreach_sequences__sequence_id__step_campaigns_get` (also callable as `g8.api.call("list_outreach_sequence_step_campaigns_integrations_linkedin_outreach_sequences__sequence_id__step_campaigns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+The campaign behind each LinkedIn step of a sequence, keyed by step id.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.sequence_id` | `string` | yes | The graph8 sequence's id. |
+
+**Returns** `ApiResponse_OutreachStepCampaigns_`: the envelope `{ data: OutreachStepCampaigns, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachStepCampaigns` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `step_campaigns` | `Record<string, OutreachStepCampaign>` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachSequenceStepCampaigns({ path: { sequence_id: "id" } });
+```
+
+---
+
+<a id="op-listoutreachtemplates"></a>
+
+### `g8.api.linkedInOutreach.listOutreachTemplates(input?)`
+
+**List Outreach Templates**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/templates`
+- operationId: `list_outreach_templates_integrations_linkedin_outreach_templates_get` (also callable as `g8.api.call("list_outreach_templates_integrations_linkedin_outreach_templates_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Pre-built campaign sequence templates.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachTemplates_`: the envelope `{ data: OutreachTemplates, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachTemplates` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `templates` | `Array<OutreachTemplate>` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachTemplates();
+```
+
+---
+
+<a id="op-listoutreachworkspaces"></a>
+
+### `g8.api.linkedInOutreach.listOutreachWorkspaces(input?)`
+
+**List Outreach Workspaces**
+
+- HTTP: `GET /api/v1/integrations/linkedin-outreach/workspaces`
+- operationId: `list_outreach_workspaces_integrations_linkedin_outreach_workspaces_get` (also callable as `g8.api.call("list_outreach_workspaces_integrations_linkedin_outreach_workspaces_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Workspaces available to select. Empty once one is selected; `current_workspace_id` then names it.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachWorkspaces_`: the envelope `{ data: OutreachWorkspaces, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachWorkspaces` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `total_count` | `integer` | yes |  |
+| `workspaces` | `Array<OutreachWorkspace>` | yes |  |
+| `current_workspace_id` | `integer \| null` | no |  |
+| `current_workspace_name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.listOutreachWorkspaces();
+```
+
+---
+
+<a id="op-pauseoutreachcampaign"></a>
+
+### `g8.api.linkedInOutreach.pauseOutreachCampaign(input)`
+
+**Pause Outreach Campaign**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/pause`
+- operationId: `pause_outreach_campaign_integrations_linkedin_outreach_campaigns__campaign_id__pause_post` (also callable as `g8.api.call("pause_outreach_campaign_integrations_linkedin_outreach_campaigns__campaign_id__pause_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: `integrations:run`
+
+Stop a running campaign sending, on the platform itself. Reversible with `/resume`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.campaign_id` | `integer` | yes | The outreach campaign's id. |
+
+**Returns** `ApiResponse_OutreachCampaignActionResult_`: the envelope `{ data: OutreachCampaignActionResult, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignActionResult` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `message` | `string` | yes |  |
+| `success` | `boolean` | yes |  |
+
+**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.linkedInOutreach.pauseOutreachCampaign({ path: { campaign_id: 123 } });
+```
+
+---
+
+<a id="op-reconnectoutreach"></a>
+
+### `g8.api.linkedInOutreach.reconnectOutreach(input?)`
+
+**Reconnect Outreach**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/connection/reconnect`
+- operationId: `reconnect_outreach_integrations_linkedin_outreach_connection_reconnect_post` (also callable as `g8.api.call("reconnect_outreach_integrations_linkedin_outreach_connection_reconnect_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: `integrations:run`
+
+Refresh an expired session using the credentials already stored. Takes no credentials.
+
+`requires_login: true` means the stored ones no longer work and a person must sign in again in the app.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachReconnectResult_`: the envelope `{ data: OutreachReconnectResult, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachReconnectResult` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `message` | `string` | yes |  |
+| `success` | `boolean` | yes |  |
+| `email` | `string \| null` | no |  |
+| `requires_login` | `boolean` | no | default `false` |
+| `token_expires_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.linkedInOutreach.reconnectOutreach();
+```
+
+---
+
+<a id="op-resumeoutreachcampaign"></a>
+
+### `g8.api.linkedInOutreach.resumeOutreachCampaign(input)`
+
+**Resume Outreach Campaign**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/resume`
+- operationId: `resume_outreach_campaign_integrations_linkedin_outreach_campaigns__campaign_id__resume_post` (also callable as `g8.api.call("resume_outreach_campaign_integrations_linkedin_outreach_campaigns__campaign_id__resume_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: `integrations:run`
+
+Resume a paused campaign. OUTREACH RESTARTS IMMEDIATELY.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.campaign_id` | `integer` | yes | The outreach campaign's id. |
+
+**Returns** `ApiResponse_OutreachCampaignActionResult_`: the envelope `{ data: OutreachCampaignActionResult, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignActionResult` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `message` | `string` | yes |  |
+| `success` | `boolean` | yes |  |
+
+**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.linkedInOutreach.resumeOutreachCampaign({ path: { campaign_id: 123 } });
+```
+
+---
+
+<a id="op-searchoutreachcampaignleads"></a>
+
+### `g8.api.linkedInOutreach.searchOutreachCampaignLeads(input)`
+
+**Search Outreach Campaign Leads**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/campaigns/{campaign_id}/leads/search`
+- operationId: `search_outreach_campaign_leads_integrations_linkedin_outreach_campaigns__campaign_id__leads_search_post` (also callable as `g8.api.call("search_outreach_campaign_leads_integrations_linkedin_outreach_campaigns__campaign_id__leads_search_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `integrations:read`
+
+Who is in a campaign and what has happened to each of them. READS ONLY - POST because paging is a body.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.campaign_id` | `integer` | yes | The outreach campaign's id. |
+| `body` | `OutreachCampaignLeadsQuery` | yes | Request body; fields below. |
+
+Body fields (`OutreachCampaignLeadsQuery`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.campaign_id` | `integer \| null` | no | Ignored; the path value is used. |
+| `body.limit` | `integer` | no | Page size. Values above 1000 are capped at 1000. default `100` |
+| `body.offset` | `integer` | no | Leads to skip. default `0` |
+| `body.time_filter` | `"CreationTime" \| "Everywhere" \| null` | no |  |
+| `body.time_from` | `string \| null` | no | ISO 8601. |
+| `body.time_to` | `string \| null` | no | ISO 8601. |
+
+**Returns** `ApiResponse_OutreachCampaignLeads_`: the envelope `{ data: OutreachCampaignLeads, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachCampaignLeads` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<OutreachCampaignLead>` | yes |  |
+| `limit` | `integer` | yes |  |
+| `offset` | `integer` | yes |  |
+| `total_count` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.linkedInOutreach.searchOutreachCampaignLeads({ path: { campaign_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-selectactiveoutreachworkspace"></a>
+
+### `g8.api.linkedInOutreach.selectActiveOutreachWorkspace(input)`
+
+**Select Active Outreach Workspace**
+
+- HTTP: `PUT /api/v1/integrations/linkedin-outreach/workspaces/active`
+- operationId: `select_active_outreach_workspace_integrations_linkedin_outreach_workspaces_active_put` (also callable as `g8.api.call("select_active_outreach_workspace_integrations_linkedin_outreach_workspaces_active_put", 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: `integrations:run`
+
+Select the workspace this org sends from. ONE-TIME: a second call is a 409.
+
+Every sender account, list and campaign on this surface is read from the selected workspace.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `OutreachWorkspaceSelectRequest` | yes | Request body; fields below. |
+
+Body fields (`OutreachWorkspaceSelectRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.workspace_id` | `integer` | yes | A `workspace_id` from `GET /integrations/linkedin-outreach/workspaces`. |
+
+**Returns** `ApiResponse_OutreachWorkspaceSelected_`: the envelope `{ data: OutreachWorkspaceSelected, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachWorkspaceSelected` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `message` | `string` | yes |  |
+| `success` | `boolean` | yes |  |
+| `workspace_id` | `integer` | yes |  |
+| `workspace_name` | `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.linkedInOutreach.selectActiveOutreachWorkspace({ body: { workspace_id: 123 } });
+```
+
+---
+
+<a id="op-syncoutreachworkspace"></a>
+
+### `g8.api.linkedInOutreach.syncOutreachWorkspace(input?)`
+
+**Sync Outreach Workspace**
+
+- HTTP: `POST /api/v1/integrations/linkedin-outreach/workspaces/sync`
+- operationId: `sync_outreach_workspace_integrations_linkedin_outreach_workspaces_sync_post` (also callable as `g8.api.call("sync_outreach_workspace_integrations_linkedin_outreach_workspaces_sync_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: `integrations:run`
+
+Confirm the workspace configuration. Reads only: `success: false` means none is selected yet.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OutreachWorkspaceState_`: the envelope `{ data: OutreachWorkspaceState, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OutreachWorkspaceState` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `connected` | `boolean \| null` | no |  |
+| `message` | `string \| null` | no |  |
+| `success` | `boolean \| null` | no |  |
+| `workspace_configured` | `boolean \| null` | no |  |
+| `workspace_id` | `integer \| null` | no |  |
+| `workspace_name` | `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.linkedInOutreach.syncOutreachWorkspace();
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-outreachcampaign"></a>
+
+### `OutreachCampaign`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `name` | `string` | yes |  |
+| `status` | `string` | yes | DRAFT, ONGOING, PAUSED or FINISHED. |
+| `created_at` | `string \| null` | no |  |
+| `finished_leads` | `integer` | no | default `0` |
+| `pending_leads` | `integer` | no | default `0` |
+| `total_leads` | `integer` | no | default `0` |
+
+<a id="type-outreachcampaignlead"></a>
+
+### `OutreachCampaignLead`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `creation_time` | `string \| null` | no |  |
+| `error_code` | `string \| null` | no |  |
+| `failed_time` | `string \| null` | no |  |
+| `last_action_time` | `string \| null` | no |  |
+| `lead_campaign_status` | `string \| null` | no |  |
+| `lead_campaign_status_message` | `string \| null` | no |  |
+| `lead_connection_status` | `string \| null` | no |  |
+| `lead_message_status` | `string \| null` | no |  |
+| `linkedin_sender_full_name` | `string \| null` | no |  |
+| `linkedin_sender_id` | `integer \| null` | no |  |
+| `linkedin_user_profile` | `OutreachLeadProfile \| null` | no |  |
+| `linkedin_user_profile_id` | `string \| null` | no |  |
+
+<a id="type-outreachcampaignstatsfigures"></a>
+
+### `OutreachCampaignStatsFigures`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `campaign_id` | `integer` | yes |  |
+| `connection_acceptance_rate` | `number` | no | default `0` |
+| `connections_accepted` | `integer` | no | default `0` |
+| `connections_sent` | `integer` | no | default `0` |
+| `follows` | `integer` | no | default `0` |
+| `inmail_messages_sent` | `integer` | no | default `0` |
+| `message_reply_rate` | `number` | no | default `0` |
+| `messages_sent` | `integer` | no | default `0` |
+| `post_likes` | `integer` | no | default `0` |
+| `profile_views` | `integer` | no | default `0` |
+| `total_message_replies` | `integer` | no | default `0` |
+| `total_message_started` | `integer` | no | default `0` |
+
+<a id="type-outreachlist"></a>
+
+### `OutreachList`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `name` | `string` | yes |  |
+| `created_at` | `string \| null` | no |  |
+| `leads_count` | `integer` | no | default `0` |
+
+<a id="type-outreachprogressfigures"></a>
+
+### `OutreachProgressFigures`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `total_users` | `integer` | no | default `0` |
+| `total_users_excluded` | `integer` | no | default `0` |
+| `total_users_failed` | `integer` | no | default `0` |
+| `total_users_finished` | `integer` | no | default `0` |
+| `total_users_in_progress` | `integer` | no | default `0` |
+| `total_users_manually_stopped` | `integer` | no | default `0` |
+| `total_users_pending` | `integer` | no | default `0` |
+
+<a id="type-outreachsenderaccount"></a>
+
+### `OutreachSenderAccount`
+
+A LinkedIn account that sends outreach.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `name` | `string` | yes |  |
+| `email` | `string \| null` | no |  |
+| `is_connected` | `boolean` | no | default `true` |
+| `is_premium` | `boolean` | no | default `false` |
+| `profile_picture_url` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+
+<a id="type-outreachstepcampaign"></a>
+
+### `OutreachStepCampaign`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `campaign_id` | `integer` | yes |  |
+| `linkedin_action_type` | `string` | yes |  |
+| `status` | `string` | yes |  |
+
+<a id="type-outreachtemplate"></a>
+
+### `OutreachTemplate`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `integer` | yes |  |
+| `name` | `string` | yes |  |
+| `sequence` | `Record<string, unknown>` | yes |  |
+| `description` | `string \| null` | no |  |
+| `is_default` | `boolean` | no | default `false` |
+
+<a id="type-outreachworkspace"></a>
+
+### `OutreachWorkspace`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `workspace_id` | `integer` | yes |  |
+| `workspace_name` | `string` | yes |  |
+| `seats_limit` | `integer \| null` | no |  |
+| `used_seats` | `integer \| null` | no |  |