@whop/cli 0.14.3 → 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. |
 
 ---
 
@@ -110,9 +115,9 @@ Retrieve Account Preferences
 
 ---
 
-# whop accounts recommend_actions
+# whop accounts reserves
 
-List Recommended Actions
+List Account Reserves
 
 ## Options
 
@@ -122,15 +127,25 @@ List Recommended Actions
 
 ---
 
-# whop accounts reserves
+# whop accounts transfer_ownership
 
-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). |
+
+> Confirm with the user before executing this destructive command.
 
 ---
 
@@ -138,28 +153,34 @@ List Account Reserves
 
 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 |  | Attachment input for the account banner image. |
+| `--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. |
-| `--description` | `unknown` | no |  | Account promotional description. |
+| `--description` | `unknown` | no |  | Account promotional description. When creating a Whop-managed Facebook page, it is truncated to 155 characters and used as the About text. |
 | `--featured_affiliate_product_id` | `unknown` | no |  | The ID of the product to feature for affiliates. Pass `null` to clear. |
 | `--home_preferences` | `array` | no |  | Public account home page preferences. |
 | `--industry_group` | `unknown` | no |  | Account industry group. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
 | `--industry_type` | `unknown` | no |  | Specific industry vertical for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
 | `--invoice_prefix` | `unknown` | no |  | Prefix used for account invoices. |
-| `--logo` | `unknown` | no |  | Attachment input for the account logo. |
+| `--logo` | `unknown` | no |  | Account logo, used as the profile picture when creating a Whop-managed Facebook page. Image files up to 5 MB. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
 | `--metadata` | `object` | no |  | Arbitrary key/value metadata to store on the account. |
 | `--onboarding_type` | `unknown` | no |  | The type of onboarding the account has completed. |
-| `--opengraph_image` | `unknown` | no |  | Attachment input for the account Open Graph image. |
+| `--opengraph_image` | `unknown` | no |  | Open Graph preview media used when the account is shared. Image and video files up to 5 MB. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
 | `--opengraph_image_variant` | `unknown` | no |  | The account Open Graph image variant. |
 | `--other_business_description` | `unknown` | no |  | The description of the business type when business_type is other. |
 | `--other_industry_description` | `unknown` | no |  | The description of the industry type when industry_type is other. |
@@ -177,6 +198,7 @@ Update Account
 | `--tax_identifiers` | `array` | no |  | Account tax/VAT registrations to add or update. When `tax_remitted_by` is `self`, tax is calculated and collected only in the countries where the account holds a registration. |
 | `--tax_remitted_by` | `string` | no |  | Determines whether Whop or the account calculates and remits tax. The account must provide a supported-country business address when it self-remits. |
 | `--tax_type` | `string` | no |  | Determines whether tax is included in the listed price or added at checkout. |
+| `--three_ds_level` | `string` | no |  | Account-level 3D Secure behavior. Set `mandate_challenge` to require cardholder verification on supported card payments, or `null` to use the standard checkout flow. |
 | `--title` | `unknown` | no |  | The display name of the account. |
 | `--use_logo_as_opengraph_image_fallback` | `boolean` | no |  | Whether the account uses its logo as the fallback Open Graph image. |
 

package/skills/whop-ad-groups/SKILL.md

@@ -26,13 +26,13 @@ Create an Ad Group
 | `--conversion_location` | `string` | no |  | Where the outcome being optimized for occurs, such as a website visit, social-profile visit, messaging conversation, ad interaction, or lead-form submission. The lead form itself is set on the ad. |
 | `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
 | `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
+| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
 | `--devices` | `object` | no |  | Device platforms and operating systems to target. |
 | `--dynamic_creative` | `boolean` | no |  | Let the ad platform automatically mix and match this ad group's creatives and copy to find the best-performing combinations. Set at creation; can't be changed afterward. |
 | `--ends_at` | `string` | no |  | When the ad group stops delivering, as an ISO 8601 timestamp. Omit to run until paused. |
-| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available with `reach` optimization. |
+| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available on campaigns with the `awareness` objective. |
 | `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
-| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when conversion_location is `messaging`. |
+| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when setting `conversion_location` to `messaging`, and rejected unless the ad group's conversion location is `messaging`. |
 | `--minimum_daily_spend` | `number` | no |  | Minimum the ad group tries to spend each day. |
 | `--optimization_goal` | `string` | no |  | The result the ad group's delivery is optimized to get the most of. |
 | `--placements` | `unknown` | no |  | `automatic` to let the ad platform choose placements, or the list of platforms and positions to target. Omit a platform's positions to target all of them.
@@ -103,7 +103,7 @@ Estimate Ad Group Reach
 | `--account_id` | `string` | no |  | Account to estimate on behalf of. Defaults to the authenticated account. |
 | `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
 | `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
+| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
 | `--devices` | `object` | no |  | Device platforms and operating systems to target. |
 | `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
 | `--platform` | `string` | yes |  | The ad network the estimate runs on. |
@@ -193,7 +193,7 @@ Search Targeting Options
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | Account to search on behalf of. Defaults to the authenticated account. |
 | `--platform` | `string` | yes |  | The ad network whose targeting taxonomy to search. |
-| `--query` | `string` | no |  | The search term. Blank browses the fixed lists; interests and locations return nothing without one. |
+| `--query` | `string` | no |  | The search term. Blank browses the fixed lists; interests, work employers, job titles, schools, majors, and locations return nothing without one. |
 | `--types` | `array` | no |  | Kinds of targeting options to search. Defaults to all of them. |
 | `--location_types` | `array` | no |  | Narrow location results to these kinds of places. Only applies when `types` includes `locations`. |
 | `--country` | `string` | no |  | Narrow location results to one country, as an ISO 3166-1 code such as `US`. Only applies when `types` includes `locations`. |
@@ -243,12 +243,12 @@ Update an Ad Group
 | `--conversion_location` | `string` | no |  | Where the outcome being optimized for occurs, such as a website visit, social-profile visit, messaging conversation, ad interaction, or lead-form submission. The lead form itself is set on the ad. |
 | `--demographics` | `object` | no |  | Age, gender, and automatic-audience targeting. |
 | `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). |
-| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
+| `--detailed_targeting` | `object` | no |  | Interest, behavior, and demographic targeting, using categories from the ad platform's targeting taxonomy. Entries across interests, behaviors, and demographics are OR'd together (anyone matching any entry is reached), matching Ads Manager's detailed-targeting box. At most 100 entries per section. Can't be combined with demographics.automatic, and unavailable to campaigns with special_ad_categories. |
 | `--devices` | `object` | no |  | Device platforms and operating systems to target. |
 | `--ends_at` | `string` | no |  | When the ad group stops delivering, as an ISO 8601 timestamp. Omit to run until paused. |
-| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available with `reach` optimization. |
+| `--frequency_cap` | `object` | no |  | Cap on how often one person sees ads from this ad group. Only available on campaigns with the `awareness` objective. |
 | `--languages` | `array` | no |  | Languages to target, as ISO 639 codes such as `en` or `es`. Empty or omitted targets all languages. |
-| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when conversion_location is `messaging`. |
+| `--message_apps` | `array` | no |  | Apps the conversation opens in. Required when setting `conversion_location` to `messaging`, and rejected unless the ad group's conversion location is `messaging`. |
 | `--minimum_daily_spend` | `number` | no |  | Minimum the ad group tries to spend each day. |
 | `--optimization_goal` | `string` | no |  | The result the ad group's delivery is optimized to get the most of. |
 | `--placements` | `unknown` | no |  | `automatic` to let the ad platform choose placements, or the list of platforms and positions to target. Omit a platform's positions to target all of them.

package/skills/whop-api-keys/SKILL.md

@@ -17,6 +17,7 @@ Create API Key
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
+| `--api_version_date` | `string` | no |  | Dated API version used when requests authenticated with this key omit the `Api-Version-Date` header. New keys default to the latest version. |
 | `--expires_at` | `unknown` | no |  | When the API key should stop working, as an ISO 8601 timestamp. Omit (or pass `null` on update) for a key that never expires. |
 | `--ip_allowlist` | `unknown` | no |  | IPv4/IPv6 CIDR ranges allowed to use this key, for example `["203.0.113.0/24"]`. Empty or `null` allows any IP. |
 | `--name` | `string` | yes |  | A human-readable name for the API key, such as 'Production API Key'. |
@@ -116,6 +117,7 @@ Update API Key
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
+| `--api_version_date` | `string` | no |  | Dated API version used when requests authenticated with this key omit the `Api-Version-Date` header. New keys default to the latest version. |
 | `--expires_at` | `unknown` | no |  | When the API key should stop working, as an ISO 8601 timestamp. Omit (or pass `null` on update) for a key that never expires. |
 | `--ip_allowlist` | `unknown` | no |  | IPv4/IPv6 CIDR ranges allowed to use this key, for example `["203.0.113.0/24"]`. Empty or `null` allows any IP. |
 | `--name` | `unknown` | no |  | A new human-readable name for the API key. |

package/skills/whop-apps/SKILL.md

@@ -18,6 +18,7 @@ Create App
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | The account to create the app for (`biz_` tag). Defaults to the account behind the presented credential. |
+| `--app_type` | `string` | no |  | The type of app to create. Defaults to `b2c_app`. |
 | `--base_url` | `unknown` | no |  | The base production URL where the app is hosted, such as `https://myapp.example.com`. |
 | `--icon` | `object` | no |  | The icon image for the app in PNG, JPEG, or GIF format, referencing an uploaded file: `{ id }` for an existing attachment or `{ direct_upload_id }` for a new direct upload. |
 | `--name` | `string` | yes |  | The display name for the app, shown to users on the app store and product pages. |
@@ -29,6 +30,20 @@ Create App
 
 ---
 
+# whop apps delete
+
+Delete App
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | App ID (prefixed `app_`), the app's claimed route, or its proxy domain id. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
 # whop apps get
 
 Retrieve App
@@ -50,9 +65,9 @@ List Apps
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--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. |
+| `--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. |
@@ -123,8 +138,8 @@ Update App
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--app_store_description` | `string` | no |  | The detailed description shown on the app store's in-depth app view page. |
-| `--app_type` | `string` | no |  | The type of end-user the app is built for. |
-| `--base_url` | `string` | no |  | The base production URL where the app is hosted. |
+| `--app_type` | `string` | no |  | The type of end-user the app is built for. Cannot be changed on an app whose type is already `website`. |
+| `--base_url` | `unknown` | no |  | The base production URL where the app is hosted. Set to `null` to take the app proxy offline. |
 | `--dashboard_path` | `unknown` | no |  | The URL path for the account dashboard view. |
 | `--description` | `string` | no |  | A short description of the app shown in listings and search results. |
 | `--discover_path` | `unknown` | no |  | The URL path for the discover view. |

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. |
@@ -90,6 +91,32 @@ List Bounties
 
 ---
 
+# whop bounties submissions
+
+List Public Submissions
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `bounty_id` | `string` | yes | The bounty whose public submissions to list (`bnty_` tag). |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--status` | `string` | no |  | Filter by lifecycle state. |
+| `--created_after` | `string` | no |  | Only submissions created after this ISO 8601 timestamp. |
+| `--created_before` | `string` | no |  | Only submissions created before this ISO 8601 timestamp. |
+| `--order` | `string` | no |  | Sort field. |
+| `--direction` | `string` | no |  | Sort direction. |
+| `--first` | `number` | no | `20` | Number of submissions to return from the start of the window. |
+| `--after` | `string` | no |  | Cursor to paginate forwards from. |
+| `--last` | `number` | no |  | Number of submissions to return from the end of the window. |
+| `--before` | `string` | no |  | Cursor to paginate backwards from. |
+
+---
+
 # whop bounties update
 
 Update Bounty
@@ -105,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-dispute-alerts/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: whop-dispute-alerts
+description: Issuer warnings that arrive before a chargeback does. Run `whop dispute-alerts --help` for usage details.
+requires_bin: whop
+command: whop dispute-alerts
+---
+
+A Dispute alert is an early warning from a card issuer that a settled payment is being questioned, ahead of any chargeback. `type` separates fraud reports (`early_fraud_warning`), pre-dispute notices (`dispute_alert`), and Visa RDR cases the network already closed by refunding (`rapid_dispute_resolution`).
+
+Use the Dispute alerts API to list alerts for an account, filter them by type or payment, and read `actionable` to see whether refunding can still avoid the chargeback.
+
+# whop dispute-alerts get
+
+Retrieve Dispute Alert
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The dispute alert ID, prefixed `dspa_`. |
+
+---
+
+# whop dispute-alerts list
+
+List Dispute Alerts
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Only alerts on this account's payments (`biz_` tag). Omit it to cover every account you can read. |
+| `--payment_id` | `string` | no |  | Only alerts on this payment (`pay_` tag). A payment can carry several. |
+| `--type` | `string` | no |  | Only alerts of this kind. `early_fraud_warning` for issuer fraud reports, `dispute_alert` for pre-dispute notices, `rapid_dispute_resolution` for Visa RDR cases the network already closed. |
+| `--first` | `number` | no |  | The number of alerts to return (default 20, max 100). |
+| `--after` | `string` | no |  | A cursor; returns alerts after this position. |
+| `--last` | `number` | no |  | The number of alerts to return from the end of the range. |
+| `--before` | `string` | no |  | A cursor; returns alerts before this position. |
+| `--order` | `string` | no |  | The field to sort alerts by. |
+| `--direction` | `string` | no |  | Sort direction. |
+| `--created_before` | `string` | no |  | Only alerts Whop received before this ISO 8601 timestamp. |
+| `--created_after` | `string` | no |  | Only alerts Whop received after this ISO 8601 timestamp. |

package/skills/whop-disputes/SKILL.md

@@ -5,9 +5,9 @@ requires_bin: whop
 command: whop disputes
 ---
 
-A Dispute is a chargeback a customer files against a payment through their bank, or a pre-dispute inquiry that may become one. It carries the disputed payment, a deadline to respond, the evidence packet you send to the payment processor, and the outcome once the processor rules.
+A Dispute is a chargeback a customer files against a payment through their bank, or an inquiry that may become one. It carries the disputed payment, a deadline to respond, your evidence, and the outcome once the processor rules.
 
-Disputes are opened by the customer's bank, never through the API, so you can read them but not create or delete them. Use the Disputes API to list and filter disputes, summarize them by status and currency for a queue view, edit the evidence packet while the dispute is still contestable, and submit that evidence for review.
+Use the Disputes API to list disputes, edit the evidence packet while a dispute is still contestable, and submit it for review.
 
 # whop disputes get
 

package/skills/whop-events/SKILL.md

@@ -83,7 +83,7 @@ Retrieve the pulse feed
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--event` | `string` | no |  | Filter to one or more types, comma separated — for example `withdrawal,card_spend`. These are the item's `type`, not its `event_name`: several types share the `ledger_line.created` event name. Omit for every type in the feed. Values outside the feed's own set are rejected. |
+| `--event` | `string` | no |  | Filter to one or more types, comma separated — for example `purchase,card_spend`. These are the item's `type`, not its `event_name`: several types share the `ledger_line.created` event name. Omit for every type in the feed. Values outside the feed's own set are rejected. |
 | `--first` | `number` | no |  | The number of events to return. |
 | `--after` | `string` | no |  | A cursor for fetching events after a previous page. |
 | `--before` | `string` | no |  | A cursor for fetching events before a later page. |

package/skills/whop-exports/SKILL.md

@@ -22,7 +22,7 @@ Create Export
 | `--filters` | `object` | no |  | Resource-specific filters. For native REST resources (`payouts`, `transfers`, `memberships`) these are the resource's own list query params; for dashboard tables they mirror the dashboard table filters.
 
 <details>
-<summary>Filters by resource (22)</summary>
+<summary>Filters by resource (25)</summary>
 
 <details>
 <summary>ad_campaigns (4)</summary>
@@ -62,6 +62,17 @@ Mirrors the filtering query params of `GET /api/v1/ads`.
 - `query` `string` — Filter ads by a title or ID substring.
 - `status` `string` — Only return ads with this status. One of `active`, `paused`, `in_review`, `rejected`.
 
+</details>
+<details>
+<summary>apps (4)</summary>
+
+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 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>
 <details>
 <summary>audiences (3)</summary>
@@ -95,6 +106,29 @@ Mirrors the filtering query params of `GET /api/v1/bounty_submissions`.
 - `created_before` `string` — Only submissions created before this ISO 8601 timestamp.
 - `status` `string` — Filter by lifecycle state. One of `in_progress`, `submitted`, `approved`, `denied`.
 
+</details>
+<details>
+<summary>card_transactions (6)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/card_transactions`.
+
+- `card_id` `string[]` — Return only transactions charged to these cards, each prefixed `icrd_`.
+- `cardholder_id` `string[]` — Return only transactions on cards assigned to these users, each prefixed `user_`.
+- `created_after` `string` — Return only transactions authorized at or after this ISO 8601 timestamp.
+- `created_before` `string` — Return only transactions authorized at or before this ISO 8601 timestamp.
+- `status` `string` — Return only transactions with this status. One of `pending`, `completed`, `reversed`, `declined`.
+- `transaction_ids` `string[]` — Return only these card transactions, each prefixed `citx_`. Repeat the parameter, or pass one comma-separated value.
+
+</details>
+<details>
+<summary>checkout_configurations (3)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/checkout_configurations`.
+
+- `created_after` `string` — Only return checkout configurations created after this ISO 8601 timestamp.
+- `created_before` `string` — Only return checkout configurations created before this ISO 8601 timestamp.
+- `plan_id` `string` — Only return checkout configurations for this plan ID, prefixed `plan_`.
+
 </details>
 <details>
 <summary>disputes (4)</summary>
@@ -129,7 +163,7 @@ Mirrors the filtering query params of `GET /api/v1/events`.
 
 </details>
 <details>
-<summary>financial-activity (8)</summary>
+<summary>financial-activity (9)</summary>
 
 Mirrors the filtering query params of `GET /api/v1/financial-activity`.
 
@@ -137,6 +171,7 @@ Mirrors the filtering query params of `GET /api/v1/financial-activity`.
 - `available_before` `string` — Only include rows whose funds became withdrawable on or before this `YYYY-MM-DD` settlement date (UTC). Set equal to available_after for a single day. Requires currency.
 - `currency` `string` — Optional currency code filter, for example `usd`.
 - `include_owned_accounts` `boolean` — When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`.
+- `include_resource` `boolean` — Whether to include the `resource` field in the response or not. Consider passing `false` if you need a fast response without as many rich details.
 - `line_types` `string[]` — Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here.
 - `posted_after` `string` — Only include rows posted after this ISO 8601 timestamp.
 - `posted_before` `string` — Only include rows posted before this ISO 8601 timestamp.
@@ -280,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-ledgers/SKILL.md

@@ -20,6 +20,7 @@ List Financial Activity
 | `--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. |
 | `--include_owned_accounts` | `boolean` | no |  | When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`. |
+| `--include_resource` | `boolean` | no | `true` | Whether to include the `resource` field in the response or not. Consider passing `false` if you need a fast response without as many rich details. |
 | `--line_types` | `array` | no |  | Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here. |
 | `--currency` | `string` | no |  | Optional currency code filter, for example `usd`. |
 | `--posted_after` | `string` | no |  | Only include rows posted after this ISO 8601 timestamp. |

package/skills/whop-memberships/SKILL.md

@@ -7,7 +7,7 @@ command: whop memberships
 
 A Membership is a customer's purchase of a plan: the subscription or one-time grant that gives them access to a product. It tracks billing state (`active`, `trialing`, `past_due`, and so on), the current period, pending cancellations, custom metadata, and the software license key when the product includes licensing.
 
-Use the Memberships API to list an account's memberships or the caller's own, retrieve one by ID or license key, and manage the lifecycle: cancel immediately or at period end, reverse a scheduled period-end cancellation, pause and resume payment collection, extend with free days, and update metadata.
+Use the Memberships API to list an account's memberships or the caller's own, retrieve one by ID or license key, invite a recipient to join through a free plan, and manage the lifecycle: cancel immediately or at period end, reverse a scheduled period-end cancellation, pause and resume payment collection, extend with free days, and update metadata.
 
 # whop memberships cancel
 
@@ -63,6 +63,23 @@ Retrieve Membership
 
 ---
 
+# whop memberships invite
+
+Invite to a Membership
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--email` | `string` | no |  | Recipient email address. Mutually exclusive with `user_id`. |
+| `--plan_id` | `string` | yes |  | Free plan whose membership the recipient is invited to, prefixed `plan_`. |
+| `--user_id` | `string` | no |  | Recipient user ID, prefixed `user_`. Mutually exclusive with `email`. |
+| `--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.
+
+---
+
 # whop memberships list
 
 List Memberships

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. |
 
 ---