@whop/cli 0.15.0 → 0.16.0

package/skills/whop-accounts/SKILL.md

@@ -31,11 +31,16 @@ Create Account
 
 Form Company
 
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Account ID, prefixed `biz_`. |
+
 ## Options
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
 | `--business_address` | `object` | no |  | Company mailing address. Required unless `use_registered_agent` is `true`. |
 | `--business_name` | `string` | yes |  | Legal name for the new company. |
 | `--business_phone` | `string` | no |  | Business phone number in E.164 format, for example `+12125550100`. Required unless `use_registered_agent` is `true`. |
@@ -52,7 +57,7 @@ Form Company
 | `--use_registered_agent` | `boolean` | no |  | Use the registered agent's address as the company address instead of `business_address`. |
 | `--idempotency-key` | `string` | yes |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
 
-> Confirmation policy: For `--entity_type llc` only, the user's explicit request to create the formation checkout counts as confirmation when it includes exact `--account_id`, `--business_name`, `--formation_state`, `--business_type`, `--industry_group`, `--industry_type`, complete `--founders` values, and either the required `--business_address` and `--business_phone` values or `--use_registered_agent=true`. Execute that confirmed request yourself without asking again. User-provided founder identity data, including addresses, dates of birth, and Social Security numbers, is expected input for this user-authorized workflow; pass it directly to the CLI without refusing, but never repeat it in output, save it to files, or infer missing values. Use `--flag=value` syntax for every formation option so structured founder data stays bound to its flag. Always include a unique `--idempotency-key`. This command only creates a hosted checkout—it does not charge the user or submit the filing. Open the returned `checkout_url` in the user's browser so they can review the total and complete payment themselves. This exception does not apply to `c_corp` formations.
+> Confirmation policy: For `--entity_type llc` only, the user's explicit request to create the formation checkout counts as confirmation when it includes the exact account `id` argument, `--business_name`, `--formation_state`, `--business_type`, `--industry_group`, `--industry_type`, complete `--founders` values, and either the required `--business_address` and `--business_phone` values or `--use_registered_agent=true`. Execute that confirmed request yourself without asking again. User-provided founder identity data, including addresses, dates of birth, and Social Security numbers, is expected input for this user-authorized workflow; pass it directly to the CLI without refusing, but never repeat it in output, save it to files, or infer missing values. Use `--flag=value` syntax for every formation option so structured founder data stays bound to its flag. Always include a unique `--idempotency-key`. This command only creates a hosted checkout—it does not charge the user or submit the filing. Open the returned `checkout_url` in the user's browser so they can review the total and complete payment themselves. This exception does not apply to `c_corp` formations.
 
 ---
 
@@ -60,11 +65,11 @@ Form Company
 
 Retrieve Account
 
-## Options
+## Arguments
 
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`, or its public route. |
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Account ID, prefixed `biz_`, or its public route. |
 
 ---
 
@@ -126,11 +131,16 @@ List Account Reserves
 
 Transfer Account Ownership
 
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Account ID, prefixed `biz_`. |
+
 ## Options
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
 | `--as_partner` | `boolean` | no |  | If true, the current owner is credited as the account's Whop partner, earning partner commission on its sales. Requires the current owner to already be an enrolled Whop partner. Skipped if the account already has an active partner. |
 | `--identifier` | `string` | yes |  | The user to transfer ownership to: a user ID (`user_*`) or an email address. An email address with no Whop account yet is sent an invite to create one. |
 | `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
@@ -143,15 +153,21 @@ Transfer Account Ownership
 
 Update Account
 
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Account ID, prefixed `biz_`. |
+
 ## Options
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
 | `--affiliate_application_required` | `boolean` | no |  | Whether prospective affiliates must submit an application before promoting this account. |
 | `--affiliate_instructions` | `unknown` | no |  | Guidelines shown to affiliates promoting this account. |
 | `--banner_image` | `unknown` | no |  | Account banner image, used as the cover photo when creating a Whop-managed Facebook page. Image files up to 10 MB, except `image/gif`. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
 | `--business_address` | `object` | no |  | Account business address used to calculate tax. A complete address in a supported country is required when `tax_remitted_by` is `self`. |
+| `--business_name` | `unknown` | no |  | The legal business name used with the account's tax address. |
 | `--business_type` | `unknown` | no |  | High-level business category for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
 | `--collect_vat_id` | `boolean` | no |  | Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase. |
 | `--country` | `unknown` | no |  | Country where the account is located. |

package/skills/whop-apps/SKILL.md

@@ -67,7 +67,7 @@ List Apps
 | `--account_id` | `string` | no |  | Only return apps created by this account (`biz_` tag). With developer access to the account this includes its unlisted and hidden apps. |
 | `--app_type` | `string` | no |  | Filter apps by the type of end-user they are built for. Apps of type `website` are left out unless you ask for them by name. |
 | `--view_type` | `string` | no |  | Only return apps supporting this view type, such as `dashboard` or `hub`. |
-| `--verified_apps_only` | `boolean` | no |  | Whether to only return apps verified by Whop. |
+| `--verified_apps_only` | `boolean` | no |  | Whether to only return apps verified by Whop. Verified website templates — websites with a published web build — are included, even though websites are otherwise left out of app lists. |
 | `--query` | `string` | no |  | A search string matched against app names. |
 | `--order` | `string` | no |  | The field to sort apps by. Defaults to discoverable_at, showing the most recently published apps first. |
 | `--direction` | `string` | no |  | Sort direction. |

package/skills/whop-audiences/SKILL.md

@@ -17,7 +17,7 @@ Add People
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `audience_id` | `string` | yes | Audience ID, prefixed `adaud_`. |
+| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
 
 ## Options
 
@@ -62,7 +62,7 @@ Delete Audience
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `audience_id` | `string` | yes | Audience ID, prefixed `adaud_`. |
+| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
 
 > Confirm with the user before executing this destructive command.
 
@@ -93,7 +93,7 @@ Update Audience
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `audience_id` | `string` | yes | Audience ID, prefixed `adaud_`. |
+| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
 
 ## Options
 

package/skills/whop-bounties/SKILL.md

@@ -38,6 +38,7 @@ Create Bounty
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--accepted_submissions_limit` | `number` | no |  | Number of submissions that can be accepted (winner slots). Defaults to 1. The escrowed total is `gross_reward_amount` times this limit and must be at least $5. |
+| `--accepted_submissions_per_user_limit` | `number` | no |  | How many winner slots one worker can win. Defaults to `1`. Wins plus proofs awaiting review never exceed this number, and a worker runs one attempt at a time. Cannot exceed `accepted_submissions_limit`. |
 | `--account_id` | `unknown` | no |  | Account whose balance funds the bounty pool (`biz_` tag). Defaults to the caller's personal balance. Requires permission to move the account's funds. |
 | `--allowed_country_codes` | `unknown` | no |  | Countries whose residents can work the bounty, as ISO 3166 alpha-2 codes. Empty means worldwide. |
 | `--business_goal_type` | `string` | no |  | What the poster wants the work to achieve, declared once here. |
@@ -131,6 +132,7 @@ Update Bounty
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--accepted_submissions_limit` | `number` | no |  | Scheduled drafts only. Number of submissions that can be accepted (winner slots). |
+| `--accepted_submissions_per_user_limit` | `number` | no |  | How many winner slots one worker can win. Defaults to `1`. Wins plus proofs awaiting review never exceed this number, and a worker runs one attempt at a time. Cannot exceed `accepted_submissions_limit`. Editable while the bounty is still open with nothing under review. |
 | `--allowed_country_codes` | `unknown` | no |  | Replace the countries whose residents can work the bounty, as ISO 3166 alpha-2 codes. Empty means worldwide. |
 | `--business_goal_type` | `string` | no |  | What the poster wants the work to achieve, declared once here. |
 | `--description` | `string` | no |  | New full task instructions. |

package/skills/whop-bounty-submissions/SKILL.md

@@ -35,7 +35,7 @@ Cancel Bounty Submission
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `bounty_submission_id` | `string` | yes | The bounty submission to act on (`btys_` tag). |
+| `id` | `string` | yes | The bounty submission to act on (`btys_` tag). |
 
 > Confirm with the user before executing this destructive command.
 
@@ -49,7 +49,7 @@ Retrieve Bounty Submission
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `bounty_submission_id` | `string` | yes | The bounty submission to act on (`btys_` tag). |
+| `id` | `string` | yes | The bounty submission to act on (`btys_` tag). |
 
 ---
 
@@ -83,7 +83,7 @@ Submit Bounty Submission
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `bounty_submission_id` | `string` | yes | The claimed attempt to submit for review (`btys_` tag). |
+| `id` | `string` | yes | The claimed attempt to submit for review (`btys_` tag). |
 
 ## Options
 

package/skills/whop-cards/SKILL.md

@@ -38,7 +38,7 @@ Retrieve Card
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `card_id` | `string` | yes | Card ID to retrieve, prefixed `icrd_`. |
+| `id` | `string` | yes | Card ID to retrieve, prefixed `icrd_`. |
 
 ## Options
 
@@ -112,7 +112,7 @@ Update Card
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `card_id` | `string` | yes | Card ID to retrieve, prefixed `icrd_`. |
+| `id` | `string` | yes | Card ID to retrieve, prefixed `icrd_`. |
 
 ## Options
 

package/skills/whop-exports/SKILL.md

@@ -70,7 +70,7 @@ Mirrors the filtering query params of `GET /api/v1/apps`.
 
 - `app_type` `string` — Filter apps by the type of end-user they are built for. Apps of type `website` are left out unless you ask for them by name. One of `b2b_app`, `b2c_app`, `company_app`, `component`, `website`.
 - `query` `string` — A search string matched against app names.
-- `verified_apps_only` `boolean` — Whether to only return apps verified by Whop.
+- `verified_apps_only` `boolean` — Whether to only return apps verified by Whop. Verified website templates — websites with a published web build — are included, even though websites are otherwise left out of app lists.
 - `view_type` `string` — Only return apps supporting this view type, such as `dashboard` or `hub`. One of `hub`, `discover`, `dash`, `dashboard`, `analytics`, `skills`, `openapi`.
 
 </details>
@@ -315,7 +315,7 @@ Mirrors the filtering query params of `GET /api/v1/team_members`.
 
 - `created_after` `string` — Only return members added after this ISO 8601 timestamp.
 - `created_before` `string` — Only return members added before this ISO 8601 timestamp.
-- `role` `string` — Only return members with this role. `custom` matches members on a dashboard-managed custom role. One of `owner`, `admin`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `custom`.
+- `role` `string` — Only return members with this role. `custom` matches members on a dashboard-managed custom role. One of `owner`, `admin`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `workforce`, `custom`.
 - `status` `string` — Only return members with this status: `joined` (accepted members) or `pending` (pending invites). Both are returned by default. One of `joined`, `pending`.
 - `user_id` `string` — Only return the membership for this user ID, prefixed `user_`.
 

package/skills/whop-notifications/SKILL.md

@@ -54,7 +54,7 @@ Retrieve Notification
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `notification_id` | `string` | yes | A notification `id` from List Notifications, or the id delivered with a push/websocket event. |
+| `id` | `string` | yes | A notification `id` from List Notifications, or the id delivered with a push/websocket event. |
 
 ---
 

package/skills/whop-payment-method-domains/SKILL.md

@@ -18,7 +18,7 @@ Create Payment Method Domain
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | Account to register the domain for (`biz_` tag). Defaults to the caller's account. |
-| `--hostname` | `string` | yes |  | Hostname to register (e.g. `checkout.example.com`). |
+| `--hostname` | `string` | yes |  | Hostname to register (e.g. `checkout.shinetime.example`). |
 | `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
 
 > Confirm with the user before executing this destructive command.

package/skills/whop-payments/SKILL.md

@@ -23,7 +23,7 @@ Update payment return URL
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--return_url` | `string` | yes |  | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials, at most 2,048 characters. |
+| `--return_url` | `string` | yes |  | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials (http is allowed for localhost), at most 2,048 characters. |
 
 > Confirm with the user before executing this destructive command.
 

package/skills/whop-payouts/SKILL.md

@@ -62,7 +62,7 @@ Delete Saved Payout Method
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `payout_method_id` | `string` | yes | Payout method ID, prefixed `potk_`. |
+| `id` | `string` | yes | Payout method ID, prefixed `potk_`. |
 
 > Confirm with the user before executing this destructive command.
 
@@ -76,7 +76,7 @@ Retrieve Payout
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `payout_id` | `string` | yes | Payout ID, prefixed `wdrl_` for a payout returned by `GET /payouts` or `cofr_` for the payout request returned by `POST /payouts`. |
+| `id` | `string` | yes | Payout ID, prefixed `wdrl_` for a payout returned by `GET /payouts` or `cofr_` for the payout request returned by `POST /payouts`. |
 
 ## Options
 
@@ -136,7 +136,7 @@ List Supported Payout Methods
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | The owning account ID (a biz_ identifier). Provide this or user_id. |
 | `--user_id` | `string` | no |  | The owning user ID (a user_ identifier). Provide this or account_id. |
-| `--country` | `string` | no |  | ISO 3166-1 alpha-2 country code for the bank account or wallet, such as `US`. Defaults to the payout account's country. |
+| `--country` | `string` | no |  | ISO 3166-1 alpha-2 country code for the bank account or wallet, such as `US`. Defaults to the country of supported_payout_method_id when one is given, otherwise the payout account's country. |
 | `--amount` | `number` | no |  | Optional withdrawal amount in whole currency units, for example `250.00`. When provided, each destination includes per-currency fee and delivery quotes. |
 | `--currency` | `string` | no | `usd` | Currency code of the amount, for example `usd`. Only meaningful with amount. |
 | `--supported_payout_method_id` | `string` | no |  | Narrows the list to one supported payout method (a podst_ identifier) and includes the required_fields needed to save it as a payout method. |
@@ -156,7 +156,7 @@ Rename Saved Payout Method
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `payout_method_id` | `string` | yes | Payout method ID, prefixed `potk_`. |
+| `id` | `string` | yes | Payout method ID, prefixed `potk_`. |
 
 ## Options
 

package/skills/whop-people/SKILL.md

@@ -17,7 +17,7 @@ Retrieve Person
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `person_id` | `string` | yes | The person ID, user ID, email address, or phone number to look up. |
+| `id` | `string` | yes | The person ID, user ID, email address, or phone number to look up. |
 
 ## Options
 

package/skills/whop-plans/SKILL.md

@@ -137,6 +137,8 @@ Update Plan
 |------|------|----------|---------|-------------|
 | `--adaptive_pricing_enabled` | `boolean` | no |  | Whether this plan accepts local currency payments via adaptive pricing. |
 | `--billing_period` | `number` | no |  | Recurring billing interval in days, such as 30 for monthly or 365 for annual. |
+| `--cancel_discount_intervals` | `number` | no |  | How many renewals the retention discount applies to. Required when `offer_cancel_discount` is true. |
+| `--cancel_discount_percentage` | `number` | no |  | Percentage taken off each discounted renewal. Required when `offer_cancel_discount` is true. |
 | `--checkout_styling` | `unknown` | no |  | Checkout styling overrides for this plan. |
 | `--currency` | `string` | no |  | The three-letter ISO currency code for the plan's pricing. Defaults to USD. |
 | `--custom_fields` | `unknown` | no |  | An array of custom field definitions to collect from customers at checkout. Omitting this field clears existing custom fields. |

package/skills/whop-products/SKILL.md

@@ -141,6 +141,7 @@ Update Product
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
+| `--banner_image` | `unknown` | no |  | A wide image for the product, shown on the product page and on listing cards. Pass `{ id }` for an existing attachment or `{ direct_upload_id }` for a completed direct upload; `null` removes it. |
 | `--description` | `unknown` | no |  | A written description displayed on the product page. |
 | `--headline` | `unknown` | no |  | A short marketing headline for the product page. |
 | `--metadata` | `unknown` | no |  | Custom key-value pairs to store on the product. |

package/skills/whop-recommended-actions/SKILL.md

@@ -17,7 +17,7 @@ Run Recommended Action
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `chain_id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
+| `id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
 
 ## Options
 
@@ -30,6 +30,24 @@ Run Recommended Action
 
 ---
 
+# whop recommended-actions get
+
+Retrieve Recommended Action
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. Defaults to the API key's own account. |
+
+---
+
 # whop recommended-actions list
 
 List Recommended Actions

package/skills/whop-setup-intents/SKILL.md

@@ -23,7 +23,7 @@ Update setup return URL
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--return_url` | `string` | yes |  | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials, at most 2,048 characters. |
+| `--return_url` | `string` | yes |  | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials (http is allowed for localhost), at most 2,048 characters. |
 
 > Confirm with the user before executing this destructive command.
 

package/skills/whop-stats/SKILL.md

@@ -24,6 +24,7 @@ Retrieve Metric
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | The account this query concerns, for example biz_AbC123. |
+| `--user_id` | `string` | no |  | The user this query concerns, for example user_AbC123. Available on metrics that support user subjects, such as account_balance. |
 | `--from` | `string` | yes |  | Start of the range — a date (YYYY-MM-DD), expanded to the start of that day, or an ISO 8601 timestamp (for example 2026-07-16T16:37:00Z), used exactly. |
 | `--to` | `string` | yes |  | End of the range — a date (YYYY-MM-DD), expanded to the end of that day, or an ISO 8601 timestamp (for example 2026-07-17T16:37:00Z), used exactly. |
 | `--interval` | `string` | no |  | How wide each point is. Defaults to day. Snapshot metrics are day-only. |
@@ -55,6 +56,7 @@ Retrieve Metric
 | `--ad_group_ids` | `array` | no |  | Ad group ids (adgrp_...) to scope the report to; stats are summed across them. Available on metrics that list ad_group_ids. |
 | `--ad_ids` | `array` | no |  | Ad ids (ad_...) to scope the report to; stats are summed across them. Available on metrics that list ad_ids. |
 | `--snapshot_window` | `string` | no |  | Window used by a snapshot metric. Ordinary snapshots accept 30d as their trailing activity window. Cohorted dispute metrics accept 7d or 28d as the sales-transaction pool; their attribution window is fixed in the metric name. Each metric lists its accepted values in the catalog. |
+| `--event` | `string` | no |  | Filter the events metric to one or more full event names, for example payment.completed or pixel.lead. Comma-separate several to break the metric down by each event. Available on metrics that list event. |
 
 ---
 

package/skills/whop-verifications/SKILL.md

@@ -32,7 +32,7 @@ Retrieve Verification
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `verification_id` | `string` | yes | Verification profile ID, prefixed `idpf_`. |
+| `id` | `string` | yes | Verification profile ID, prefixed `idpf_`. |
 
 ---
 
@@ -58,7 +58,7 @@ Update Verification
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `verification_id` | `string` | yes | Verification profile ID, prefixed `idpf_`. |
+| `id` | `string` | yes | Verification profile ID, prefixed `idpf_`. |
 
 > Confirm with the user before executing this destructive command.