@whop/cli 0.14.1 → 0.14.2

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

@@ -9,19 +9,261 @@ An Ad Group sits inside an [ad campaign](https://docs.whop.com/api-reference/bet
 
 Use the Ad Groups API to create ad groups in campaigns, list or retrieve targeting and delivery settings, update budgets or targeting, delete groups that should stop running, and pause or resume delivery. It can also search the ad platform's targeting taxonomy for options to target and estimate how many people a draft targeting spec can reach.
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `whop ad-groups list` | List Ad Groups |
-| `whop ad-groups create` | Create an Ad Group |
-| `whop ad-groups estimate_reach` | Estimate Ad Group Reach |
-| `whop ad-groups targeting_options` | Search Targeting Options |
-| `whop ad-groups delete` | Delete an Ad Group |
-| `whop ad-groups get` | Retrieve an Ad Group |
-| `whop ad-groups update` | Update an Ad Group |
-| `whop ad-groups duplicate` | Duplicate an Ad Group |
-| `whop ad-groups pause` | Pause an Ad Group |
-| `whop ad-groups unpause` | Unpause an Ad Group |
-
-Run `whop ad-groups <command> --help` for options, or `whop ad-groups <command> --schema` for full argument details.
+# whop ad-groups create
+
+Create an Ad Group
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--ad_campaign_id` | `string` | yes |  | The ad campaign to create the ad group in, prefixed `adcamp_`. |
+| `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
+| `--bid_type` | `string` | no |  | How delivery bids are set in the ad auction. Target-based strategies use `desired_cost_per_result`. |
+| `--budget_amount` | `number` | no |  | This ad group's budget, in the ad account's currency. Omit when the budget is set on the campaign instead. |
+| `--budget_type` | `string` | no |  | Whether budget_amount is spent per day (`daily`) or over the ad group's full run (`lifetime`). |
+| `--conversion_event` | `unknown` | no |  | The pixel event optimized for. A standard event, or any custom pixel event name. |
+| `--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. |
+| `--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. |
+| `--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`. |
+| `--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.
+
+Valid positions per platform:
+
+- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`
+- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`
+- `messenger`: `story`
+- `audience_network`: `classic`, `rewarded_video`
+- `threads`: `threads_stream`
+- `whatsapp`: `status` |
+| `--regions` | `object` | no |  | Locations to target and exclude. |
+| `--starts_at` | `string` | no |  | When the ad group starts delivering, as an ISO 8601 timestamp. Omit to start as soon as it's active. |
+| `--status` | `string` | no |  | Initial status (default: `active`). |
+| `--title` | `string` | no |  | The display name of the ad group. |
+| `--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 ad-groups delete
+
+Delete an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
+# whop ad-groups duplicate
+
+Duplicate an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--count` | `number` | no |  | Number of copies to create (1-10). Defaults to 1. |
+| `--preserve_engagement` | `boolean` | no |  | Whether the copied ads keep the original posts' engagement (likes, comments, shares). Defaults to false. |
+| `--target_ad_campaign_id` | `string` | no |  | Campaign to duplicate into. Defaults to the ad group's own campaign. |
+| `--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 ad-groups estimate_reach
+
+Estimate Ad Group Reach
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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. |
+| `--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. |
+| `--regions` | `object` | no |  | Locations to target and exclude. |
+| `--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 ad-groups get
+
+Retrieve an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--stats_from` | `string` | no |  | Start of the stats window. |
+| `--stats_to` | `string` | no |  | End of the stats window. |
+| `--time_zone` | `string` | no |  | IANA timezone the stats window is interpreted in. Defaults to UTC. |
+| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
+
+---
+
+# whop ad-groups list
+
+List Ad Groups
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account whose ad groups to list. Defaults to the authenticated account. |
+| `--ad_campaign_id` | `string` | no |  | Filter to ad groups in this campaign. |
+| `--ad_campaign_ids` | `array` | no |  | Filter to ad groups in these campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b). |
+| `--status` | `string` | no |  | Filter to ad groups with this status. |
+| `--query` | `string` | no |  | Filter ad groups by a title or ID substring. |
+| `--order` | `string` | no |  | The field to sort by. Defaults to created_at. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports. |
+| `--direction` | `string` | no |  | The sort direction. Defaults to desc. |
+| `--created_before` | `string` | no |  | Only return ad groups created before this timestamp. |
+| `--created_after` | `string` | no |  | Only return ad groups created after this timestamp. |
+| `--stats_from` | `string` | no |  | Start of the stats window. Defaults to all-time. |
+| `--stats_to` | `string` | no |  | End of the stats window. Defaults to now. |
+| `--time_zone` | `string` | no |  | IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC. |
+| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
+| `--first` | `number` | no | `20` | The number of ad groups to return. |
+| `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |
+| `--last` | `number` | no |  | The number of ad groups to return from the end of the range. |
+| `--before` | `string` | no |  | Cursor to fetch the page before (from page_info.start_cursor). |
+
+---
+
+# whop ad-groups pause
+
+Pause an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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 ad-groups targeting_options
+
+Search Targeting Options
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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. |
+| `--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`. |
+| `--limit` | `number` | no | `25` | Maximum number of results per requested type. |
+
+---
+
+# whop ad-groups unpause
+
+Unpause an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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 ad-groups update
+
+Update an Ad Group
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad group ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--audiences` | `object` | no |  | Saved audiences to deliver to or exclude. Can't be combined with demographics.automatic. |
+| `--bid_type` | `string` | no |  | How delivery bids are set in the ad auction. Target-based strategies use `desired_cost_per_result`. |
+| `--budget_amount` | `number` | no |  | This ad group's budget, in the ad account's currency. Omit when the budget is set on the campaign instead. |
+| `--budget_type` | `string` | no |  | Whether budget_amount is spent per day (`daily`) or over the ad group's full run (`lifetime`). |
+| `--conversion_event` | `unknown` | no |  | The pixel event optimized for. A standard event, or any custom pixel event name. |
+| `--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. |
+| `--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. |
+| `--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`. |
+| `--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.
+
+Valid positions per platform:
+
+- `facebook`: `feed`, `right_hand_column`, `marketplace`, `search`, `profile_feed`, `notification`, `story`, `instream_video`, `facebook_reels`, `facebook_reels_overlay`, `biz_disco_feed`
+- `instagram`: `stream`, `story`, `explore`, `explore_home`, `reels`, `profile_feed`, `profile_reels`, `ig_search`
+- `messenger`: `story`
+- `audience_network`: `classic`, `rewarded_video`
+- `threads`: `threads_stream`
+- `whatsapp`: `status` |
+| `--regions` | `object` | no |  | Locations to target and exclude. |
+| `--starts_at` | `string` | no |  | When the ad group starts delivering, as an ISO 8601 timestamp. Omit to start as soon as it's active. |
+| `--status` | `string` | no |  | Initial status (default: `active`). |
+| `--title` | `string` | no |  | The display name of the ad group. |
+
+> Confirm with the user before executing this destructive command.

package/skills/whop-ads/SKILL.md

@@ -9,20 +9,196 @@ An Ad is the individual creative unit delivered by an [ad group](https://docs.wh
 
 Use the Ads API to list ads for an account, create ads inside ad groups, retrieve or update creative details, delete ads that should stop running, and pause or resume delivery.
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `whop ads list` | List Ads |
-| `whop ads create` | Create an Ad |
-| `whop ads delete` | Delete an Ad |
-| `whop ads get` | Retrieve an Ad |
-| `whop ads update` | Update an Ad |
-| `whop ads duplicate` | Duplicate an Ad |
-| `whop ads pause` | Pause an Ad |
-| `whop ads unpause` | Unpause an Ad |
-
-Run `whop ads <command> --help` for options, or `whop ads <command> --schema` for full argument details.
+# whop ads create
+
+Create an Ad
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--ad_group` | `object` | no |  | An inline ad group to create (same shape as POST /ad_groups, including ad_campaign_id). Creates the ad group and the ad together. Provide this OR ad_group_id. |
+| `--ad_group_id` | `string` | no |  | The existing ad group to create the ad in. Provide this OR ad_group, not both. |
+| `--call_to_action` | `string` | no |  | The call-to-action button shown on the ad. |
+| `--creatives` | `array` | no |  | The ad's creative assets. Each entry is an uploaded file id with an optional format; omit format for the original asset. Two or more entries with no format become a carousel (2-10 attachments), in order, sharing the ad's copy. |
+| `--descriptions` | `array` | no |  | The description variants shown on the ad. |
+| `--headlines` | `array` | no |  | The headline variants shown on the ad. |
+| `--lead_form` | `object` | no |  | Instant lead form for the ad. Only allowed when the ad group's conversion_location is an instant-form destination (instant_forms, instant_forms_and_messenger, website_and_instant_forms). Mutually exclusive with lead_form_id. |
+| `--lead_form_id` | `string` | no |  | Use an existing instant form instead of creating one — the form's platform ID, from a form already on the ad's Facebook page. Only allowed when the ad group's conversion_location is an instant-form destination. Mutually exclusive with lead_form. |
+| `--messaging_config` | `object` | no |  | Click-to-message welcome copy: the greeting (message) and the ice-breaker prompt (keyword). |
+| `--multi_advertiser_ads` | `boolean` | no |  | Whether the ad can appear alongside other advertisers' ads in the same unit. Defaults to true. |
+| `--post_id` | `string` | no |  | Promote an existing post instead of uploading creatives — a Facebook post or Instagram media id. Mutually exclusive with creatives. Pair with post_source. |
+| `--post_source` | `string` | no |  | Identifies the network that owns `post_id`. The source is inferred from the ID shape when omitted. |
+| `--primary_texts` | `array` | no |  | The primary text variants shown in the ad body. |
+| `--social_accounts` | `array` | no |  | The social accounts the ad runs under — a connected Facebook page and, optionally, an Instagram profile. |
+| `--title` | `string` | no |  | The display name of the ad. |
+| `--url` | `string` | no |  | The URL the ad links to. |
+| `--url_parameters` | `object` | no |  | Query parameters appended to the destination URL, keyed by parameter name. |
+| `--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 ads delete
+
+Delete an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
+# whop ads duplicate
+
+Duplicate an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--count` | `number` | no |  | Number of copies to create (1-10). Defaults to 1. |
+| `--preserve_engagement` | `boolean` | no |  | Whether the copies keep the original post's engagement (likes, comments, shares). Defaults to false. |
+| `--target_ad_group_id` | `string` | no |  | Ad group to duplicate into. Defaults to the ad's own ad group. |
+| `--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 ads get
+
+Retrieve an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--stats_from` | `string` | no |  | Start of the stats window. |
+| `--stats_to` | `string` | no |  | End of the stats window. |
+| `--time_zone` | `string` | no |  | IANA timezone the stats window is interpreted in. Defaults to UTC. |
+| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
+
+---
+
+# whop ads list
+
+List Ads
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The account the ads belong to. Defaults to the account-scoped key's own account. |
+| `--ad_campaign_id` | `string` | no |  | Only return ads in this ad campaign. |
+| `--ad_campaign_ids` | `array` | no |  | Only return ads in these ad campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b). |
+| `--ad_group_id` | `string` | no |  | Only return ads in this ad group. |
+| `--ad_group_ids` | `array` | no |  | Only return ads in these ad groups (max 100). Repeat the parameter for each id (ad_group_ids=a&ad_group_ids=b). |
+| `--status` | `string` | no |  | Only return ads with this status. |
+| `--query` | `string` | no |  | Filter ads by a title or ID substring. |
+| `--order` | `string` | no |  | The field to sort by. Defaults to created_at. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports. |
+| `--direction` | `string` | no |  | The sort direction. Defaults to desc. |
+| `--created_before` | `string` | no |  | Only return ads created before this timestamp. |
+| `--created_after` | `string` | no |  | Only return ads created after this timestamp. |
+| `--stats_from` | `string` | no |  | Start of the stats window. Defaults to all-time. |
+| `--stats_to` | `string` | no |  | End of the stats window. Defaults to now. |
+| `--time_zone` | `string` | no |  | IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC. |
+| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
+| `--first` | `number` | no | `20` | The number of ads to return. |
+| `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |
+| `--last` | `number` | no |  | The number of ads to return from the end of the range. |
+| `--before` | `string` | no |  | Cursor to fetch the page before (from page_info.start_cursor). |
+
+---
+
+# whop ads pause
+
+Pause an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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 ads unpause
+
+Unpause an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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 ads update
+
+Update an Ad
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The ad ID. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--call_to_action` | `string` | no |  | The call-to-action button shown on the ad. |
+| `--creatives` | `array` | no |  | The ad's creative assets. Each entry is an uploaded file id with an optional format; omit format for the original asset. Replaces a live ad's creative on the platform. Two or more entries with no format replace it with a carousel (2-10 attachments), in order, sharing the ad's copy. |
+| `--descriptions` | `array` | no |  | The description variants shown on the ad. |
+| `--headlines` | `array` | no |  | The headline variants shown on the ad. |
+| `--lead_form` | `object` | no |  | Instant lead form for the ad. Only allowed when the ad group's conversion_location is an instant-form destination (instant_forms, instant_forms_and_messenger, website_and_instant_forms). Mutually exclusive with lead_form_id. |
+| `--lead_form_id` | `string` | no |  | Use an existing instant form instead of creating one — the form's platform ID, from a form already on the ad's Facebook page. Only allowed when the ad group's conversion_location is an instant-form destination. Mutually exclusive with lead_form. Replaces a stored lead_form. |
+| `--messaging_config` | `object` | no |  | Click-to-message welcome copy: the greeting (message) and the ice-breaker prompt (keyword). |
+| `--multi_advertiser_ads` | `boolean` | no |  | Whether the ad can appear alongside other advertisers' ads in the same unit. Defaults to true. |
+| `--post_id` | `string` | no |  | Promote an existing post instead of uploading creatives — a Facebook post or Instagram media id. Mutually exclusive with creatives. Pair with post_source. |
+| `--post_source` | `string` | no |  | Identifies the network that owns `post_id`. The source is inferred from the ID shape when omitted. |
+| `--primary_texts` | `array` | no |  | The primary text variants shown in the ad body. |
+| `--social_accounts` | `array` | no |  | The social accounts the ad runs under — a connected Facebook page and, optionally, an Instagram profile. |
+| `--title` | `string` | no |  | The display name of the ad. |
+| `--url` | `string` | no |  | The URL the ad links to. |
+| `--url_parameters` | `object` | no |  | Query parameters appended to the destination URL, keyed by parameter name. |
+
+> Confirm with the user before executing this destructive command.
 
 ## Launch playbook — from nothing to a live ad
 

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

@@ -9,16 +9,116 @@ An API Key is a programmatic credential owned by an account or app. Each key car
 
 Use the API Keys API to list an account or app's keys, create a key (the full secret is returned once, on creation), inspect a key's effective grants, update its name or restrictions, rotate its secret, and revoke it. These endpoints require a user session — they cannot be called with an API key.
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `whop api-keys list` | List API Keys |
-| `whop api-keys create` | Create API Key |
-| `whop api-keys permissions` | List the Permission Catalog |
-| `whop api-keys delete` | Delete API Key |
-| `whop api-keys get` | Retrieve API Key |
-| `whop api-keys update` | Update API Key |
-| `whop api-keys rotate` | Rotate API Key |
-
-Run `whop api-keys <command> --help` for options, or `whop api-keys <command> --schema` for full argument details.
+# whop api-keys create
+
+Create API Key
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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'. |
+| `--permissions` | `object` | yes |  | The permissions policy for the API key: explicit permission statements, or a system role to inherit from. Statements without a `resources` array default to the owning account (Account API keys) or every key-addressable resource (App API keys). |
+| `--resource_id` | `string` | yes |  | The account (`biz_`) or app (`app_`) tag to create the API key for. |
+| `--resource_type` | `string` | yes |  | The type of resource that will own this API key. |
+| `--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 api-keys delete
+
+Delete API Key
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | API key ID, prefixed `apik_`. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
+# whop api-keys get
+
+Retrieve API Key
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | API key ID, prefixed `apik_`. |
+
+---
+
+# whop api-keys list
+
+List API Keys
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--resource_id` | `string` | yes |  | The account (`biz_`) or app (`app_`) tag to list API keys for. |
+| `--resource_type` | `string` | yes |  | The type of resource that owns the API keys. |
+| `--created_before` | `number` | no |  | Only return API keys created before this ISO 8601 timestamp. |
+| `--created_after` | `number` | no |  | Only return API keys created after this ISO 8601 timestamp. |
+| `--first` | `number` | no |  | The number of API keys to return (default 20, max 100). |
+| `--after` | `string` | no |  | A cursor; returns API keys after this position. |
+| `--last` | `number` | no |  | The number of API keys to return from the end of the range. |
+| `--before` | `string` | no |  | A cursor; returns API keys before this position. |
+| `--order` | `string` | no |  | The field to sort API keys by. |
+| `--direction` | `string` | no |  | Sort direction. |
+
+---
+
+# whop api-keys permissions
+
+List the Permission Catalog
+
+---
+
+# whop api-keys rotate
+
+Rotate API Key
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | API key ID, prefixed `apik_`. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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 api-keys update
+
+Update API Key
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | API key ID, prefixed `apik_`. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--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. |
+| `--permissions` | `object` | no |  | The permissions policy for the API key: explicit permission statements, or a system role to inherit from. Statements without a `resources` array default to the owning account (Account API keys) or every key-addressable resource (App API keys). |
+
+> Confirm with the user before executing this destructive command.