@whop/cli 0.14.2 → 0.15.0

package/skills/whop-payouts/SKILL.md

@@ -7,7 +7,7 @@ command: whop payouts
 
 Payouts represent money sent from an account or user balance to an external destination, such as a bank account, wallet, or other saved payout method.
 
-Use the Payouts API to create payouts from accounts, list payout history for accounts or users, monitor payout statuses, and show expected arrival details for funds leaving Whop.
+Use the Payouts API to create and track payouts, manage saved payout methods, and show expected arrival details for funds leaving Whop.
 
 # whop payouts create
 
@@ -17,10 +17,16 @@ Create Payout
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | yes |  | The account to pay out from (a biz_ identifier). |
+| `--account_id` | `string` | no |  | Account to pay out from, prefixed `biz_`. Provide exactly one of `account_id` or `user_id`. |
+| `--acknowledge_bank_warning` | `boolean` | no |  | Set to `true` to continue when the destination bank could not confirm the payout method account holder's name, or `false` to have the payout refused in that case so the account holder can correct the name or link their bank first. Omitting the field skips the warning gate — a client that cannot show the warning keeps its pre-gate behavior. |
 | `--amount` | `number` | yes |  | The amount to pay out in the specified currency. |
-| `--currency` | `string` | no |  | The payout currency. Defaults to usd. |
+| `--currency` | `string` | no |  | The currency to pay out. Balances are held per currency and the payout draws only from the balance in this currency, so match the currency the funds arrived in — for example `cad` for an account funded by CAD transfers. Defaults to `usd`. |
+| `--idempotency_key` | `unknown` | no |  | A unique key that makes retries safe. Retrying with the same key returns the original payout instead of paying out twice. Also accepted as the `Idempotency-Key` header. |
+| `--notes` | `unknown` | no |  | Free-form notes to attach to the payout, with a maximum of 255 characters. Omit or pass `null` for no notes. |
 | `--payout_method_id` | `string` | yes |  | The saved payout method to deliver to (a potk_ identifier). |
+| `--platform_covers_fees` | `boolean` | no |  | Whether the parent platform covers the payout fee instead of the account being paid out. Omit to use the platform's configured fee coverage policy; pass `false` to opt out of it. `true` is only accepted for accounts that belong to a platform, and requires the platform's policy to cover this payout method's category or a caller authorized to manage the platform's child account fees. |
+| `--speed` | `string` | no |  | How fast the funds should arrive. `instant` is only accepted when the account and payout method are eligible; otherwise the payout is rejected. |
+| `--user_id` | `string` | no |  | User to pay out from, prefixed `user_`. Provide exactly one of `account_id` or `user_id`. |
 | `--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.
@@ -35,13 +41,13 @@ Create Saved Payout Method
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The account to add the payout method for (a biz_ identifier). Provide this or user_id. |
+| `--account_id` | `string` | no |  | The account to add the payout method for, prefixed `biz_`. Provide this or `user_id`. |
 | `--destination_currency` | `string` | no | `usd` | Currency the supported payout method delivers payouts in. |
-| `--fields` | `object` | yes |  | The supported payout method's required field values, keyed by field id — list them with `GET /payouts/supported_methods?supported_payout_method_id=...`. A Basis Theory token id may be passed in place of a raw value. A validation failure returns the method's full required_fields schema alongside the error. |
+| `--fields` | `object` | no |  | The supported payout method's required field values, keyed by field id — list them with `GET /payouts/supported_methods?supported_payout_method_id=...`. A Basis Theory token id may be passed in place of a raw value. For a U.S. bank routing-number field, a raw nine-digit value must also pass the ABA checksum. A validation failure returns the method's full required_fields schema alongside the error. Required whenever the account details are supplied directly. |
 | `--is_default` | `boolean` | no | `false` | Whether to make this the account's default payout method. |
-| `--nickname` | `string` | yes |  | A label for the payout method, unique per destination. |
+| `--nickname` | `string` | no |  | A label for the payout method, unique per destination. |
 | `--supported_payout_method_id` | `string` | yes |  | The supported payout method to save (a podst_ identifier from a previous listing). |
-| `--user_id` | `string` | no |  | The user to add the payout method for (a user_ identifier). Provide this or account_id. |
+| `--user_id` | `string` | no |  | The user to add the payout method for, prefixed `user_`. Provide this or `account_id`. |
 | `--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.
@@ -62,6 +68,25 @@ Delete Saved Payout Method
 
 ---
 
+# whop payouts get
+
+Retrieve Payout
+
+## Arguments
+
+| 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`. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Owning account ID, prefixed `biz_`. Provide exactly one of `account_id` or `user_id`. |
+| `--user_id` | `string` | no |  | Owning user ID, prefixed `user_`. Provide exactly one of `account_id` or `user_id`. |
+
+---
+
 # whop payouts list
 
 List Payouts
@@ -137,6 +162,6 @@ Rename Saved Payout Method
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--nickname` | `string` | yes |  | New label for the payout method. |
+| `--nickname` | `string` | yes |  | New label for the payout method, with at least one non-whitespace character and a maximum of 100 characters. |
 
 > Confirm with the user before executing this destructive command.

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

@@ -0,0 +1,41 @@
+---
+name: whop-recommended-actions
+description: Suggested next-step action chains for an account. Run `whop recommended-actions --help` for usage details.
+requires_bin: whop
+command: whop recommended-actions
+---
+
+A Recommended Action Chain is a short, ordered sequence of dashboard actions — create a product, price it, publish it — suggested for an account based on what it already has. Seeded chains come from hand-written presets; generated chains, produced per account, share the same shape.
+
+Use the Recommended Actions API to list the chains recommended for an account and to record that a chain was run. Running a chain executes nothing server-side — the client follows each step's CTA itself; the run endpoint records the `recommended_action_chain.executed` analytics event.
+
+# whop recommended-actions create
+
+Run Recommended Action
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `chain_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. |
+| `--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 recommended-actions list
+
+List Recommended Actions
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. Defaults to the API key's own account. |

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

@@ -0,0 +1,40 @@
+---
+name: whop-setup-intents
+description: Saving a buyer's payment method without charging it. Run `whop setup-intents --help` for usage details.
+requires_bin: whop
+command: whop setup-intents
+---
+
+A Setup Intent saves a buyer's payment method for later without taking money now. It runs the same collection flow a payment does, so the buyer may still owe a step — 3D Secure on a card, a hosted enrollment, or linking a bank account.
+
+Poll [Retrieve status](https://docs.whop.com/api-reference/beta/setup-intents/retrieve-status) for how far the setup has got and what is outstanding. Once it reaches `succeeded` the method is on file and can be charged.
+
+# whop setup-intents return_url
+
+Update setup return URL
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `setup_intent_id` | `string` | yes | The unique identifier of the setup intent. |
+
+## Options
+
+| 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. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
+# whop setup-intents status
+
+Retrieve setup status
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `setup_intent_id` | `string` | yes | The unique identifier of the setup intent. |

package/skills/whop-social-accounts/SKILL.md

@@ -35,8 +35,8 @@ Create a Social Account
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account. |
-| `--platform` | `string` | yes |  | The platform to create the social account on. |
+| `--account_id` | `string` | no |  | The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account. Account API keys cannot update their own account's branding through Update Account; use a user-authenticated path. |
+| `--platform` | `string` | yes |  | The platform to create the social account on. `facebook` requires the account's `banner_image`, `logo`, and `description`; configure them with [Update Account](/api-reference/beta/accounts/update-account). |
 | `--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-swaps/SKILL.md

@@ -18,10 +18,11 @@ Create Swap
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | yes |  | Business or user account ID (biz_* / user_*). |
-| `--amount` | `unknown` | no |  | Source token amount. Required for crypto swaps. Optional for fiat pairs: the portion of the negative to_token balance to repay, which must not exceed the debt; omit to repay the full debt. |
+| `--amount` | `unknown` | no |  | Source token amount. Required for crypto swaps. For fiat pairs: the amount of from_token to convert at the mid-market rate; omit (along with to_amount) to repay the full negative to_token balance instead. |
 | `--from_chain` | `number` | no |  | Source chain name or chain ID. Defaults to the source token's chain when omitted. |
 | `--from_token` | `string` | yes |  | Source token contract address or ticker symbol, such as "USDT". |
 | `--slippage_bps` | `number` | no |  | Maximum slippage tolerance in basis points. |
+| `--to_amount` | `unknown` | no |  | Fiat pairs only: sizes a partial repayment of the negative to_token balance, denominated in to_token. Must not exceed the debt. Mutually exclusive with amount. |
 | `--to_chain` | `number` | no |  | Destination chain name or chain ID. Defaults to the destination token's chain when omitted. |
 | `--to_token` | `string` | yes |  | Destination token contract address or ticker symbol, such as "XAUT". |
 | `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |

package/skills/whop-transfers/SKILL.md

@@ -74,7 +74,7 @@ List Transfer Recipients
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--origin_id` | `string` | yes |  | The originating account ID, prefixed `biz_`. |
-| `--query` | `string` | no |  | Search users and accounts by name, username, or ID, in the dashboard's relevance order — this additionally requires the member:basic:read scope. Omit it to get the origin account's team members followed by your own other accounts. Complete email addresses return no matches. |
+| `--origin_id` | `string` | yes |  | The account sending the money: a company account ID (`biz_`), or a user ID (`user_`) for that user's own personal balance. |
+| `--query` | `string` | no |  | Search anyone on Whop by name or username, plus your own accounts by name or ID. Omit it to get the team around the balance, the people you follow, and your own accounts. The list is the same whether the balance belongs to a company or to you. Searching from a `biz_` origin additionally requires the member:basic:read scope. A credential scoped to a single company is the exception to the search itself: it only ever sees that company's own people. Complete email addresses return no matches. |
 | `--first` | `number` | no | `20` | Number of recipients per page. Search queries preserve the dashboard's 20-result maximum. |
 | `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |

package/skills/whop-users/SKILL.md

@@ -22,6 +22,30 @@ Check User Access
 
 ---
 
+# whop users authorize-app
+
+Authorize an App
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Authorize the app for one of the user's accounts rather than for the user alone, prefixed `biz_`. The user must have access to it. |
+| `--client_id` | `string` | yes |  | The app being authorized, prefixed `app_`. |
+| `--code_challenge` | `string` | yes |  | The PKCE code challenge: the base64url-encoded SHA-256 of your code verifier, without padding. |
+| `--code_challenge_method` | `string` | yes |  | How `code_challenge` was derived. Only `S256` is accepted. |
+| `--consent_shown` | `boolean` | no | `true` | Whether the consent UI listed these scopes for the user. Sending `false` succeeds only when the user has already granted every scope requested. |
+| `--nonce` | `string` | no |  | OIDC nonce, echoed into the resulting ID token. Required when `requested_scopes` includes `openid`. |
+| `--redirect_uri` | `string` | yes |  | Where to send the user once they have consented. Must match one of the app's registered redirect URIs exactly — it is compared as a string, not normalized. |
+| `--requested_scopes` | `array` | yes |  | The permissions the app is asking for, for example `member:basic:read`. `GET /api_keys/permissions` names and describes each one. Granting adds to whatever the user already granted this app rather than replacing it. |
+| `--response_type` | `string` | no |  | The OAuth response type. Only `code` is accepted; defaults to `code`. |
+| `--state` | `string` | no |  | Opaque value appended to `redirect_url` unchanged, for the client to correlate the response with its request. |
+| `--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 users delete-passkey
 
 Delete
@@ -242,6 +266,7 @@ Update User
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | The account whose profile override to update. Required for API key callers. |
+| `--banner` | `unknown` | no |  |  |
 | `--bio` | `string` | no |  |  |
 | `--name` | `string` | no |  |  |
 | `--profile_picture` | `object` | no |  |  |
@@ -260,6 +285,7 @@ Update Current User
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | When set, updates the authenticated user's profile override for this account instead of their global profile. |
+| `--banner` | `unknown` | no |  |  |
 | `--bio` | `string` | no |  |  |
 | `--name` | `string` | no |  |  |
 | `--profile_picture` | `object` | no |  |  |
@@ -277,6 +303,7 @@ Update
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
+| `--bounty_worker_onboarding_dismissed` | `boolean` | no |  | Whether the user has dismissed the first-time bounty worker onboarding. Set to `false` to show it again. |
 | `--investigation_enabled` | `boolean` | no |  | Whether investigation mode is enabled for the user. Only meaningful for staff users with investigation access. |
 
 > Confirm with the user before executing this destructive command.