@whop/cli 0.16.0 → 0.16.1

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

@@ -1,126 +0,0 @@
----
-name: whop-api-keys
-description: Programmatic credentials for an account or app. Run `whop api-keys --help` for usage details.
-requires_bin: whop
-command: whop api-keys
----
-
-An API Key is a programmatic credential owned by an account or app. Each key carries its own permissions policy — explicit permission statements or an inherited system role — and can be restricted with an expiration date and an IP allowlist.
-
-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.
-
-# whop api-keys create
-
-Create API Key
-
-## Options
-
-| 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'. |
-| `--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 |
-|------|------|----------|---------|-------------|
-| `--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. |
-| `--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.

package/skills/whop-app-builds/SKILL.md

@@ -1,81 +0,0 @@
----
-name: whop-app-builds
-description: Versioned build artifacts deployed to an app's platforms. Run `whop app-builds --help` for usage details.
-requires_bin: whop
-command: whop app-builds
----
-
-An App Build is a versioned artifact uploaded for an app — a hosted web archive, or an iOS/Android bundle. Builds start as drafts, go through review, and one approved build per platform is served to users as the production build.
-
-Use the App Builds API to upload a build for an app, list an app's builds with platform and status filters, retrieve a build, and promote a draft or approved build to production.
-
-# whop app-builds create
-
-Create App Build
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--ai_prompt_id` | `string` | no |  | The AI prompt that generated this build, if applicable. |
-| `--app_id` | `string` | no |  | The app to create the build for, prefixed `app_`. Defaults to the app behind the presented credential. |
-| `--attachment` | `object` | yes |  | The uploaded build file: `{ id }` for an existing file or `{ direct_upload_id }` for a completed direct upload. |
-| `--checksum` | `string` | yes |  | A client-generated checksum of the build file, used to verify file integrity when unpacked. |
-| `--platform` | `string` | yes |  | The target platform for the build. |
-| `--source_attachment` | `object` | no |  | An optional compressed archive (.zip or .gz) of the source code that produced this build, stored alongside the build so it can be downloaded later. Referenced like `attachment`, and must be a different file. |
-| `--supported_app_view_types` | `array` | no |  | The view types this build supports. Only list the ones its code implements. |
-| `--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 app-builds get
-
-Retrieve App Build
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | App build ID, prefixed `abld_`. |
-
----
-
-# whop app-builds list
-
-List App Builds
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--app_id` | `string` | yes |  | The app to list builds for, prefixed `app_`. |
-| `--platform` | `string` | no |  | Filter builds by target platform. |
-| `--status` | `string` | no |  | Filter builds by review status. |
-| `--created_before` | `number` | no |  | Only return builds created before this ISO 8601 timestamp. |
-| `--created_after` | `number` | no |  | Only return builds created after this ISO 8601 timestamp. |
-| `--first` | `number` | no |  | The number of builds to return (default 20, max 100). |
-| `--after` | `string` | no |  | A cursor; returns builds after this position. |
-| `--last` | `number` | no |  | The number of builds to return from the end of the range. |
-| `--before` | `string` | no |  | A cursor; returns builds before this position. |
-
----
-
-# whop app-builds promote
-
-Promote App Build
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | App build ID, prefixed `abld_`. |
-
-## 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.

package/skills/whop-apps/SKILL.md

@@ -1,161 +0,0 @@
----
-name: whop-apps
-description: "Apps you build on Whop: metadata, hosted builds, runtime logs. Run `whop apps --help` for usage details."
-requires_bin: whop
-command: whop apps
----
-
-An App is software you build on Whop. It can be a hosted web app served at `<route>.whop.app` or an API integration installed as an experience, and it belongs to the account that owns its credentials, settings, builds, and runtime logs.
-
-Use the Apps API to manage app configuration and, for hosted apps, read server runtime logs for console output, uncaught exceptions, and failed requests. Logs are retained for 7 days and can be filtered by build, level, time window, and message text.
-
-# whop apps create
-
-Create App
-
-## Options
-
-| 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. |
-| `--redirect_uris` | `array` | no |  | The whitelisted OAuth callback URLs that users are redirected to after authorizing the app. |
-| `--route` | `unknown` | no |  | The subdomain route where the app's hosted web builds are served, such as `myapp` for myapp.whop.app. |
-| `--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 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
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | App ID (prefixed `app_`), the app's claimed route, or its proxy domain id. |
-
----
-
-# whop apps list
-
-List Apps
-
-## Options
-
-| 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. 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 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. |
-| `--first` | `number` | no |  | The number of apps to return (default 20, max 100). |
-| `--after` | `string` | no |  | A cursor; returns apps after this position. |
-| `--last` | `number` | no |  | The number of apps to return from the end of the range. |
-| `--before` | `string` | no |  | A cursor; returns apps before this position. |
-
----
-
-# whop apps logs
-
-List App Logs
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ID of the app, which will look like app_*************. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--app_build_id` | `string` | no |  | Only return logs from this build. |
-| `--level` | `string` | no |  | Only return console lines of this level. |
-| `--query` | `string` | no |  | Only return logs whose message contains this text (case-insensitive). |
-| `--created_after` | `string` | no |  | Start of the time window as an ISO 8601 timestamp. Defaults to 7 days before created_before. |
-| `--created_before` | `string` | no |  | End of the time window as an ISO 8601 timestamp. Defaults to now. |
-| `--first` | `number` | no |  | The number of log lines to return (max 500). |
-| `--after` | `string` | no |  | A cursor for fetching logs after a previous page. |
-| `--before` | `string` | no |  | A cursor for fetching logs before a later page. |
-
----
-
-# whop apps permissions
-
-Update App Permissions
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | App ID, prefixed `app_`. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--requested_permissions` | `array` | yes |  | The full set of permissions the app requests on install; permissions not listed are removed. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop apps update
-
-Update App
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | App ID (prefixed `app_`), the app's claimed route, or its proxy domain id. |
-
-## Options
-
-| 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. 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. |
-| `--experience_path` | `unknown` | no |  | The URL path for the member-facing hub view, such as `/experiences/[experienceId]`. |
-| `--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` | no |  | The display name for the app, shown to users on the app store and product pages. |
-| `--oauth_client_type` | `string` | no |  | How the app authenticates at the OAuth token endpoint. |
-| `--openapi_path` | `unknown` | no |  | The URL path to the app's OpenAPI spec file (requires the ai_chat capability). |
-| `--production_android_build_id` | `unknown` | no |  | The app build (`abld_` tag) to serve as the Android production build, or `null` to unassign it. Same rules as `production_web_build_id`. |
-| `--production_ios_build_id` | `unknown` | no |  | The app build (`abld_` tag) to serve as the iOS production build, or `null` to unassign it. Same rules as `production_web_build_id`. |
-| `--production_web_build_id` | `unknown` | no |  | The app build (`abld_` tag) to serve as the web production build, or `null` to unassign it. The build must belong to this app, target web, and be in the draft or approved status; a draft build is queued for approval and takes over once approved. Requires the `developer:manage_builds` scope. |
-| `--redirect_uris` | `array` | no |  | The whitelisted OAuth callback URLs users are redirected to after authorizing the app. |
-| `--required_scopes` | `array` | no |  | The OAuth scopes the app requests from users when they install it. |
-| `--route` | `string` | no |  | The subdomain route where the app's hosted web builds are served. |
-| `--secrets` | `object` | no |  | Secrets to add or overwrite on the app, as an object of string values. Keys not included are left untouched; pass null or an empty string as the value to delete a secret. Encrypted at rest and injected into the app's hosted server runtime. |
-| `--skills_path` | `unknown` | no |  | The URL path to the app's skills directory (requires the ai_chat capability). |
-| `--status` | `string` | no |  | Controls whether the app is published on Whop discovery or accessible only through its direct link. Publishing requires a name, icon, and description. |
-
-> Confirm with the user before executing this destructive command.

package/skills/whop-audiences/SKILL.md

@@ -1,105 +0,0 @@
----
-name: whop-audiences
-description: Reusable targeting lists for ad groups. Run `whop audiences --help` for usage details.
-requires_bin: whop
-command: whop audiences
----
-
-An Audience represents a customer list uploaded to Whop for ad targeting. Audiences belong to an account and sync to supported ad platforms as custom audiences.
-
-Use the Audiences API to create audiences from CSV uploads, monitor processing status, and list or delete audiences for an account. Created audiences are usable for targeting after processing reaches `ready` or `partial`.
-
-# whop audiences add_people
-
-Add People
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--file_id` | `string` | yes |  | The new customer CSV — a file id (`file_...`) returned by `POST /files`. Its headers must match the audience's saved column mapping. |
-| `--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 audiences create
-
-Create Audience
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | yes |  | Account ID, prefixed `biz_`. |
-| `--audience_type` | `string` | no |  | What to create. Defaults to `custom` (CSV upload). |
-| `--auto_refresh` | `boolean` | no |  | Filter audiences only, and set only at creation. `true` (the default) rebuilds membership from the filters twice a day. `false` keeps whoever matched at creation and never rebuilds. |
-| `--column_mapping` | `object` | no |  | Custom audiences only. Maps supported identity fields to CSV column headers. Map at least one of `email` or `phone`. |
-| `--count` | `number` | no |  | Lookalikes only. Number of lookalike audiences to create (1–6). |
-| `--file_id` | `string` | no |  | Custom audiences only. The uploaded customer CSV — a file id (`file_...`) returned by `POST /files`. |
-| `--filters` | `object` | no |  | Filter audiences only. The People filters that define membership, keyed exactly as `GET /people` accepts them — for example `{"os": "iOS", "country": "US"}`. Date filters must be rolling windows — `first_seen_within_days` or `last_seen_within_days` — so the audience re-anchors on every refresh; fixed dates such as `first_seen_after` are rejected. Source values are canonical source paths (`whop:<campaign>:<group>:<ad>`, `ext:<platform>:...`, `referrer:<domain>`, `direct`), exact or with a trailing `:*` wildcard. |
-| `--name` | `string` | no |  | Audience display name. Required for custom audiences; lookalike names are generated from the source audience. |
-| `--percentage` | `number` | no |  | Lookalikes only. Total similarity reach as a whole percent (1–20), sliced evenly across `count` — must be divisible by `count`. |
-| `--source_audience_id` | `string` | no |  | Lookalikes only. The ready custom audience (`adaud_`) to build from; it needs at least 100 matched people. |
-| `--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 audiences delete
-
-Delete Audience
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop audiences list
-
-List Audiences
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-| `--audience_id` | `string` | no |  | Audience ID, prefixed `adaud_`, used to filter the response to one audience. |
-| `--audience_type` | `string` | no |  | Filter by audience type: `custom` (uploaded lists) or `lookalike`. |
-| `--source_type` | `string` | no |  | Filter by member source: `csv_upload` (uploaded lists) or `people_filter` (automatic audiences built from saved People filters). |
-| `--first` | `number` | no |  | Number of audiences to return. Defaults to 20; maximum 100. |
-| `--after` | `string` | no |  | Cursor for the next page of audiences. |
-
----
-
-# whop audiences update
-
-Update Audience
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Audience ID, prefixed `adaud_`. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--filters` | `object` | no |  | Replaces the People filters that define membership. The whole definition is replaced rather than merged, so send every filter you want to keep — a filter you leave out stops applying. Keys and values are the ones `GET /people` accepts, such as an `os` of `iOS` or a `country` of `US`, and at least one filter is required. Date filters must be rolling windows — `first_seen_within_days` or `last_seen_within_days` — so the audience re-anchors every time it rebuilds; fixed dates such as `first_seen_after` are rejected, as is `audience_id`. An array value holds at most 500 items, and each value at most 10 KB. Only an audience with a `source_type` of `people_filter` and `auto_refresh` of `true` accepts filters: an uploaded list has no filters to replace, and with auto refresh off the audience keeps the people it matched when it was built, so create a new audience instead. |
-| `--name` | `string` | no |  | New audience display name. A blank value is ignored rather than clearing the name. |
-
-> Confirm with the user before executing this destructive command.

package/skills/whop-bounties/SKILL.md

@@ -1,145 +0,0 @@
----
-name: whop-bounties
-description: Paid tasks with reviewed submissions and escrowed rewards. Run `whop bounties --help` for usage details.
-requires_bin: whop
-command: whop bounties
----
-
-A Bounty is a paid task posted by an account or user. The reward is held in escrow when the bounty publishes, workers submit proof of completed work, and each accepted submission is paid out until every winner slot fills.
-
-Use the Bounties API to create and publish a bounty, list an account's bounties for reporting or dashboards, list the bounties a user can work or has participated in, and retrieve a single bounty by ID.
-
-# whop bounties cancel
-
-Cancel
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Bounty ID (`bnty_` tag). |
-
-## 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 bounties create
-
-Create Bounty
-
-## Options
-
-| 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. |
-| `--capture_spec` | `object` | no |  | Per-bounty overrides of the served capture contract. Only accepted when `business_goal_type` is `data_capture`; omitted fields keep the platform defaults, and the resulting contract is echoed back as `capture_spec` on the bounty. |
-| `--description` | `string` | yes |  | Full task instructions shown to workers. |
-| `--experience_id` | `unknown` | no |  | Experience to host the bounty in (`exp_` tag). Any visibility — public for an open bounty, private for an invited one. Required unless account_id is set, in which case the bounty anchors in that account's public forum. |
-| `--frequency` | `string` | no |  | How often the schedule creates a new bounty. Each occurrence is a separate bounty. Defaults to `once`; only applies with `publish_at`. |
-| `--gross_reward_amount` | `number` | yes |  | Gross bounty-pool amount (USD) escrowed per accepted submission, in whole dollars. Platform fees and affiliate shares are paid from this amount. |
-| `--publish_at` | `unknown` | no |  | ISO 8601 time to publish the bounty. When set, the bounty is created as a hidden draft and funded + published at this time instead of immediately. |
-| `--publish_at_timezone` | `unknown` | no |  | IANA timezone for recurring occurrences. Required when publish_at is set. |
-| `--title` | `string` | yes |  | Short name of the task shown to workers. |
-| `--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 bounties get
-
-Retrieve Bounty
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Bounty ID (`bnty_` tag). |
-
----
-
-# whop bounties list
-
-List Bounties
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Scope the list to this account (`biz_` tag). Requires read access to the account; account API keys may pass their own account or a connected account. |
-| `--user_id` | `string` | no |  | List the bounties this user participated in (`user_` tag). Must be the authenticated user. |
-| `--status` | `string` | no |  | Filter by lifecycle state. |
-| `--query` | `string` | no |  | Substring match on the bounty title or ID. |
-| `--created_after` | `string` | no |  | Only bounties created after this ISO 8601 timestamp. |
-| `--created_before` | `string` | no |  | Only bounties created before this ISO 8601 timestamp. |
-| `--order` | `string` | no |  | Sort field. |
-| `--direction` | `string` | no |  | Sort direction. |
-| `--first` | `number` | no | `20` | Number of bounties to return from the start of the window. |
-| `--after` | `string` | no |  | Cursor to paginate forwards from. |
-| `--last` | `number` | no |  | Number of bounties to return from the end of the window. |
-| `--before` | `string` | no |  | Cursor to paginate backwards from. |
-
----
-
-# 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
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | Bounty ID (`bnty_` tag). |
-
-## Options
-
-| 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. |
-| `--frequency` | `string` | no |  | Scheduled drafts only. How often the schedule creates a new bounty. |
-| `--gross_reward_amount` | `number` | no |  | Scheduled drafts only. Gross bounty-pool amount (USD) escrowed per accepted submission. The escrowed total (this times accepted_submissions_limit) must stay at least $5. |
-| `--publish_at` | `unknown` | no |  | Scheduled drafts only. New ISO 8601 time to publish the draft. Must be in the future. |
-| `--publish_at_timezone` | `unknown` | no |  | Scheduled drafts only. IANA timezone for recurring occurrences. |
-| `--title` | `string` | no |  | New short name of the task. |
-
-> Confirm with the user before executing this destructive command.