kenso 0.1.17 → 0.1.19

package/docs/reference.md

@@ -1,8 +1,8 @@
 # Kenso CLI command reference
 
-Generated from kenso 0.1.17 (API contracts 2b8736a3a88d) by `scripts/build-reference.ts`. Do not edit it: `pnpm build` writes it again.
+Generated from kenso 0.1.19 (API contracts 6c5f39fbe3fd) by `scripts/build-reference.ts`. Do not edit it: `pnpm build` writes it again.
 
-1376 commands, one entry each: summary, API route, feature gate and flag names. Beta commands work only on workspaces with their feature flag; `kenso describe` hides the ones yours cannot use. Every command also takes the global flags below. A command's notes, flag descriptions, body schema and examples: `kenso <resource> <action> --help`, or `kenso describe <resource> <action>` as JSON.
+1403 commands, one entry each: summary, API route, feature gate and flag names. Beta commands work only on workspaces with their feature flag; `kenso describe` hides the ones yours cannot use. Every command also takes the global flags below. A command's notes, flag descriptions, body schema and examples: `kenso <resource> <action> --help`, or `kenso describe <resource> <action>` as JSON.
 
 ## Global flags
 
@@ -144,6 +144,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [custom-variables](#custom-variables) (4)
 - [dashboard](#dashboard) (1)
 - [data-retention](#data-retention) (2)
+- [delivery-settings](#delivery-settings) (2)
 - [describe](#describe) (1)
 - [dialer-connections](#dialer-connections) (11)
 - [dialer-webhook](#dialer-webhook) (1)
@@ -163,6 +164,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [events](#events) (2)
 - [experiments](#experiments) (11)
 - [external-bookings](#external-bookings) (2)
+- [facebook-accounts](#facebook-accounts) (9)
 - [fathom-connection](#fathom-connection) (3)
 - [file-comments](#file-comments) (4)
 - [files](#files) (7)
@@ -183,6 +185,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [infra](#infra) (3)
 - [infra-action-batches](#infra-action-batches) (3)
 - [infra-action-previews](#infra-action-previews) (1)
+- [instagram-accounts](#instagram-accounts) (5)
 - [intake-settings](#intake-settings) (2)
 - [integrations](#integrations) (3)
 - [invitations](#invitations) (5)
@@ -216,7 +219,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [knowledge-website-pages](#knowledge-website-pages) (3)
 - [knowledge-writing-style](#knowledge-writing-style) (2)
 - [learnings](#learnings) (1)
-- [linkedin-accounts](#linkedin-accounts) (7)
+- [linkedin-accounts](#linkedin-accounts) (8)
 - [linkedin-connections](#linkedin-connections) (2)
 - [linkedin-inbound](#linkedin-inbound) (1)
 - [linkedin-inbound-seats](#linkedin-inbound-seats) (1)
@@ -248,6 +251,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [meeting-types](#meeting-types) (6)
 - [meetings](#meetings) (26)
 - [members](#members) (10)
+- [message-media](#message-media) (2)
 - [microsoft-teams-admin-consent-sessions](#microsoft-teams-admin-consent-sessions) (1)
 - [migration-connections](#migration-connections) (9)
 - [migration-runs](#migration-runs) (7)
@@ -272,7 +276,7 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [performance-deal](#performance-deal) (8)
 - [permission-templates](#permission-templates) (5)
 - [person-behavior](#person-behavior) (1)
-- [placement-tests](#placement-tests) (3)
+- [placement-tests](#placement-tests) (4)
 - [portal-sessions](#portal-sessions) (1)
 - [prompt-templates](#prompt-templates) (5)
 - [prompt-versions](#prompt-versions) (3)
@@ -345,6 +349,8 @@ Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 not found, 5 some rows failed, 6 r
 - [webhook-endpoints](#webhook-endpoints) (8)
 - [webhook-event-types](#webhook-event-types) (1)
 - [website](#website) (8)
+- [whatsapp-accounts](#whatsapp-accounts) (5)
+- [whatsapp-settings](#whatsapp-settings) (2)
 - [white-label](#white-label) (1)
 - [white-label-brand](#white-label-brand) (5)
 - [white-label-children](#white-label-children) (5)
@@ -571,7 +577,7 @@ Flags: `--account-type`, `--data`, `--each`, `--concurrency`.
 
 Create an account from its domains. `POST /v1/accounts`. Beta: needs `accounts`.
 
-Flags: `--skip-research`, `--name`, `--stage`, `--owner-member-id`, `--fit-score`, `--why-now`, `--angle`, `--cadence-days`, `--industry`, `--funding-round`, `--employee-count`, `--hq-location`, `--linkedin-url`, `--ken-company-id`, `--sends-from-inbox-id`, `--sends-from-linked-in-account-id`, `--source`, `--no-skip-research`, `--data`, `--each`, `--concurrency`.
+Flags: `--skip-research`, `--name`, `--stage`, `--owner-member-id`, `--fit-score`, `--why-now`, `--angle`, `--cadence-days`, `--industry`, `--funding-round`, `--employee-count`, `--hq-location`, `--linkedin-url`, `--ken-company-id`, `--sends-from-inbox-id`, `--sends-from-linked-in-account-id`, `--sends-from-whats-app-account-id`, `--source`, `--no-skip-research`, `--data`, `--each`, `--concurrency`.
 
 ### kenso accounts delete
 
@@ -649,7 +655,7 @@ Flags: `--q`, `--sort`, `--limit`, `--cursor`, `--include-total`, `--time-zone`,
 
 Update account fields. Absent fields stay unchanged; null clears. `PATCH /v1/accounts/{accountId}`. Beta: needs `accounts`.
 
-Flags: `--account-id` (required), `--name`, `--stage`, `--owner-member-id`, `--fit-score`, `--why-now`, `--angle`, `--cadence-days`, `--industry`, `--funding-round`, `--employee-count`, `--hq-location`, `--linkedin-url`, `--ken-company-id`, `--sends-from-inbox-id`, `--sends-from-linked-in-account-id`, `--overwrite-pinned`, `--tier-override`, `--is-customer`, `--account-type`, `--no-overwrite-pinned`, `--no-is-customer`, `--data`, `--each`, `--concurrency`.
+Flags: `--account-id` (required), `--name`, `--stage`, `--owner-member-id`, `--fit-score`, `--why-now`, `--angle`, `--cadence-days`, `--industry`, `--funding-round`, `--employee-count`, `--hq-location`, `--linkedin-url`, `--ken-company-id`, `--sends-from-inbox-id`, `--sends-from-linked-in-account-id`, `--sends-from-whats-app-account-id`, `--overwrite-pinned`, `--sends-from-instagram-account-id`, `--tier-override`, `--is-customer`, `--account-type`, `--no-overwrite-pinned`, `--no-is-customer`, `--data`, `--each`, `--concurrency`.
 
 ## ad-audiences
 
@@ -3299,6 +3305,20 @@ Change the workspace's data retention period. `PATCH /v1/data-retention`. Beta:
 
 Flags: `--months`, `--data`, `--each`, `--concurrency`.
 
+## delivery-settings
+
+### kenso delivery-settings get
+
+Return the workspace's delivery settings. `GET /v1/delivery-settings`. Beta: needs `placement_native`.
+
+Flags: `--each`, `--concurrency`.
+
+### kenso delivery-settings update
+
+Update the workspace's delivery settings. `PATCH /v1/delivery-settings`. Beta: needs `placement_native`.
+
+Flags: `--placement-auto-pause`, `--no-placement-auto-pause`, `--data`, `--each`, `--concurrency`.
+
 ## describe
 
 ### kenso describe
@@ -3739,6 +3759,62 @@ List external bookings. `GET /v1/external-bookings` (a list). Beta: needs `meeti
 
 Flags: `--account-id`, `--campaign-id`, `--cursor`, `--limit`, `--person-id`, `--provider`, `--start-after`, `--start-before`, `--status`, `--all`, `--each`, `--concurrency`.
 
+## facebook-accounts
+
+### kenso facebook-accounts create-connect-session
+
+Start connecting a new Facebook account. `POST /v1/facebook-accounts/connect-sessions`. Beta: needs `facebook_outreach`.
+
+Flags: `--each`, `--concurrency`.
+
+### kenso facebook-accounts create-reconnect-session
+
+Start a hosted session that reconnects the account. `POST /v1/facebook-accounts/{facebookAccountId}/reconnect-sessions`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts delete
+
+Remove a Facebook account from Kenso. `DELETE /v1/facebook-accounts/{facebookAccountId}`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts get
+
+Return one Facebook account in the current workspace. `GET /v1/facebook-accounts/{facebookAccountId}`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts list
+
+List Facebook accounts in the current workspace. `GET /v1/facebook-accounts` (a list). Beta: needs `facebook_outreach`.
+
+Flags: `--cursor`, `--limit`, `--all`, `--each`, `--concurrency`.
+
+### kenso facebook-accounts pause
+
+Pause automated actions from the account. `POST /v1/facebook-accounts/{facebookAccountId}/pause`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts reset-ramp
+
+Restart the account's ramp from today with its current plan. `POST /v1/facebook-accounts/{facebookAccountId}/ramp/reset`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts resume
+
+Resume automated actions from the account. `POST /v1/facebook-accounts/{facebookAccountId}/resume`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--each`, `--concurrency`.
+
+### kenso facebook-accounts update
+
+Update a Facebook account. Absent fields stay unchanged. `PATCH /v1/facebook-accounts/{facebookAccountId}`. Beta: needs `facebook_outreach`.
+
+Flags: `--facebook-account-id` (required), `--timezone`, `--min-mutual-friends`, `--data`, `--each`, `--concurrency`.
+
 ## fathom-connection
 
 ### kenso fathom-connection connect
@@ -4271,6 +4347,38 @@ Preview a bulk inbox or domain action. `POST /v1/infra/action-previews`. Beta: n
 
 Flags: `--action`, `--data`, `--each`, `--concurrency`.
 
+## instagram-accounts
+
+### kenso instagram-accounts create-connect-session
+
+Start connecting a new Instagram account, or reconnect one. `POST /v1/instagram-accounts/connect-sessions`. Beta: needs `instagram`.
+
+Flags: `--name`, `--instagram-account-id`, `--data`, `--each`, `--concurrency`.
+
+### kenso instagram-accounts delete
+
+Remove an Instagram account from Kenso. `DELETE /v1/instagram-accounts/{instagramAccountId}`. Beta: needs `instagram`.
+
+Flags: `--instagram-account-id` (required), `--each`, `--concurrency`.
+
+### kenso instagram-accounts get
+
+Return one Instagram account in the current workspace. `GET /v1/instagram-accounts/{instagramAccountId}`. Beta: needs `instagram`.
+
+Flags: `--instagram-account-id` (required), `--each`, `--concurrency`.
+
+### kenso instagram-accounts list
+
+List Instagram accounts in the current workspace. `GET /v1/instagram-accounts` (a list). Beta: needs `instagram`.
+
+Flags: `--cursor`, `--limit`, `--all`, `--each`, `--concurrency`.
+
+### kenso instagram-accounts update
+
+Update an Instagram account. Absent fields stay unchanged. `PATCH /v1/instagram-accounts/{instagramAccountId}`. Beta: needs `instagram`.
+
+Flags: `--instagram-account-id` (required), `--name`, `--daily-cap`, `--timezone`, `--paused`, `--no-paused`, `--data`, `--each`, `--concurrency`.
+
 ## intake-settings
 
 ### kenso intake-settings get
@@ -5013,6 +5121,12 @@ Preview a Sales Navigator search or list. `POST /v1/linkedin-accounts/{linkedinA
 
 Flags: `--linkedin-account-id` (required), `--url`, `--data`, `--each`, `--concurrency`.
 
+### kenso linkedin-accounts reset-ramp
+
+Restart a LinkedIn account's ramp. `POST /v1/linkedin-accounts/{linkedinAccountId}/ramp/reset`.
+
+Flags: `--linkedin-account-id` (required), `--each`, `--concurrency`.
+
 ### kenso linkedin-accounts update
 
 Update a LinkedIn account. `PATCH /v1/linkedin-accounts/{linkedinAccountId}`.
@@ -5903,6 +6017,20 @@ Change a member's role. `PATCH /v1/members/{memberId}`.
 
 Flags: `--member-id` (required), `--role`, `--data`, `--each`, `--concurrency`.
 
+## message-media
+
+### kenso message-media create
+
+Upload an image for messages. `POST /v1/message-media`. Beta: needs `whatsapp`.
+
+Flags: `--file`, `--data`, `--each`, `--concurrency`.
+
+### kenso message-media get
+
+Get an uploaded image. `GET /v1/message-media/{mediaId}`. Beta: needs `whatsapp`.
+
+Flags: `--media-id` (required), `--each`, `--concurrency`.
+
 ## microsoft-teams-admin-consent-sessions
 
 ### kenso microsoft-teams-admin-consent-sessions create
@@ -6637,11 +6765,17 @@ Flags: `--person-id` (required), `--each`, `--concurrency`.
 
 ## placement-tests
 
+### kenso placement-tests availability
+
+Return what the start dialog needs to offer a Kenso placement test. `GET /v1/placement-tests/availability`.
+
+Flags: `--each`, `--concurrency`.
+
 ### kenso placement-tests create
 
 Start a placement test. `POST /v1/placement-tests`.
 
-Flags: `--campaign-id`, `--inbox-id`, `--domain-id`, `--sequence-version-id`, `--campaign-segment-id`, `--contact-id`, `--random-segment`, `--random-lead`, `--random-scope`, `--random-copy-version`, `--open-pixel`, `--no-random-segment`, `--no-random-lead`, `--no-random-scope`, `--no-random-copy-version`, `--no-open-pixel`, `--data`, `--each`, `--concurrency`.
+Flags: `--campaign-id`, `--inbox-id`, `--domain-id`, `--sequence-version-id`, `--campaign-segment-id`, `--contact-id`, `--random-segment`, `--random-lead`, `--random-scope`, `--random-copy-version`, `--open-pixel`, `--control`, `--subject`, `--body`, `--no-random-segment`, `--no-random-lead`, `--no-random-scope`, `--no-random-copy-version`, `--no-open-pixel`, `--no-control`, `--data`, `--each`, `--concurrency`.
 
 ### kenso placement-tests get
 
@@ -6653,7 +6787,7 @@ Flags: `--placement-test-id` (required), `--each`, `--concurrency`.
 
 List placement tests. `GET /v1/placement-tests` (a list).
 
-Flags: `--campaign-id`, `--cursor`, `--limit`, `--all`, `--each`, `--concurrency`.
+Flags: `--campaign-id`, `--cursor`, `--domain-id`, `--inbox-id`, `--limit`, `--all`, `--each`, `--concurrency`.
 
 ## portal-sessions
 
@@ -8207,7 +8341,7 @@ Flags: `--touch-id` (required), `--updated-at`, `--recipient-version`, `--data`,
 
 Plan a touch on an account. `POST /v1/touches`. Beta: needs `accounts`.
 
-Flags: `--account-id`, `--stakeholder-id`, `--channel`, `--due-at`, `--reason`, `--title`, `--subject`, `--body`, `--rationale`, `--judge-score`, `--asset-link-id`, `--data`, `--each`, `--concurrency`.
+Flags: `--account-id`, `--stakeholder-id`, `--channel`, `--due-at`, `--reason`, `--title`, `--subject`, `--body`, `--rationale`, `--judge-score`, `--asset-link-id`, `--whatsapp-account-id`, `--find-number`, `--no-find-number`, `--data`, `--each`, `--concurrency`.
 
 ### kenso touches delete
 
@@ -8273,7 +8407,7 @@ Flags: `--touch-id` (required), `--action`, `--updated-at`, `--data`, `--each`,
 
 Edit a touch's title, channel, content or due time. `PATCH /v1/touches/{touchId}`. Beta: needs `accounts`.
 
-Flags: `--touch-id` (required), `--title`, `--channel`, `--subject`, `--body`, `--rationale`, `--due-at`, `--stakeholder-id`, `--asset-link-id`, `--data`, `--each`, `--concurrency`.
+Flags: `--touch-id` (required), `--title`, `--channel`, `--subject`, `--body`, `--rationale`, `--due-at`, `--stakeholder-id`, `--asset-link-id`, `--whatsapp-account-id`, `--find-number`, `--no-find-number`, `--data`, `--each`, `--concurrency`.
 
 ## tracking-links
 
@@ -8681,6 +8815,52 @@ List the human visits to the website. `GET /v1/website/visits` (a list). Beta: n
 
 Flags: `--account-id`, `--cursor`, `--known`, `--limit`, `--page-id`, `--person-id`, `--since`, `--no-known`, `--all`, `--each`, `--concurrency`.
 
+## whatsapp-accounts
+
+### kenso whatsapp-accounts create-connect-session
+
+Start a hosted WhatsApp connect or reconnect session. `POST /v1/whatsapp-accounts/connect-sessions`. Beta: needs `whatsapp`.
+
+Flags: `--whatsapp-account-id`, `--data`, `--each`, `--concurrency`.
+
+### kenso whatsapp-accounts delete
+
+Delete a WhatsApp account. `DELETE /v1/whatsapp-accounts/{whatsappAccountId}`. Beta: needs `whatsapp`.
+
+Flags: `--whatsapp-account-id` (required), `--each`, `--concurrency`.
+
+### kenso whatsapp-accounts get
+
+Return one WhatsApp account in the current workspace. `GET /v1/whatsapp-accounts/{whatsappAccountId}`. Beta: needs `whatsapp`.
+
+Flags: `--whatsapp-account-id` (required), `--each`, `--concurrency`.
+
+### kenso whatsapp-accounts list
+
+List WhatsApp accounts in the current workspace. `GET /v1/whatsapp-accounts` (a list). Beta: needs `whatsapp`.
+
+Flags: `--cursor`, `--limit`, `--all`, `--each`, `--concurrency`.
+
+### kenso whatsapp-accounts update
+
+Update a WhatsApp account. Absent fields stay unchanged. `PATCH /v1/whatsapp-accounts/{whatsappAccountId}`. Beta: needs `whatsapp`.
+
+Flags: `--whatsapp-account-id` (required), `--daily-new-chat-cap`, `--daily-message-cap`, `--reset-caps`, `--timezone`, `--reset-working-hours`, `--paused`, `--no-reset-caps`, `--no-reset-working-hours`, `--no-paused`, `--data`, `--each`, `--concurrency`.
+
+## whatsapp-settings
+
+### kenso whatsapp-settings get
+
+Return the workspace's WhatsApp setting. `GET /v1/whatsapp-settings`. Beta: needs `whatsapp`.
+
+Flags: `--each`, `--concurrency`.
+
+### kenso whatsapp-settings update
+
+Change the workspace's WhatsApp setting. `PATCH /v1/whatsapp-settings`. Beta: needs `whatsapp`.
+
+Flags: `--allow-eu-eea-uk`, `--no-allow-eu-eea-uk`, `--data`, `--each`, `--concurrency`.
+
 ## white-label
 
 ### kenso white-label get

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenso",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "The Kenso CLI: bulk lead, CRM and Studio work for people and coding agents",
   "license": "MIT",
   "type": "module",
@@ -44,5 +44,5 @@
     "typescript-eslint": "8.71.1",
     "vitest": "5.0.3"
   },
-  "gitHead": "4b7b6d671753dee817768174b36add31a0a6897e"
+  "gitHead": "85fa76e053149f11545406c1fc480a72a913d06f"
 }