apps

Each project has one app per platform/storefront (one for iOS, one for Android, etc.).

Read commands list, view, public-keys, storekit-config work on any app. Write commands create, update, delete use the v2 app endpoints; pass --file <path> for any non-trivial body since the schema is wide and storefront-specific.

Subcommands

Command	Description
apps create	Create an app under the active project
apps delete <app_id>	Delete an app (hard delete)
apps list	List apps in the active project
apps public-keys <app_id>	List the public SDK keys for an app
apps storekit-config <app_id>	Print the StoreKit configuration for an iOS app
apps update <app_id>	Update an app
apps view <id>	Show one app

Full flag reference: see the CLI reference.

Read examples

revcat apps list
revcat apps view app_abc123
revcat apps public-keys app_abc123
revcat apps storekit-config app_abc123 | jq .

Create

The v2 body is discriminated by type. Shortcut flags cover the most common platforms; for everything else pass --file.

# iOS
revcat apps create --type app_store --bundle com.acme.app --name "Acme iOS"

# Android
revcat apps create --type play_store --package com.acme.app --name "Acme Android"

# Anything else (Stripe, rc_billing, paddle, roku, mac_app_store, or app_store
# with optional shared_secret / App Store Connect API key, etc.)
revcat apps create --file ./new-stripe.json

# stdin
echo '{"name":"Web","type":"stripe","stripe":{"stripe_account_id":"acct_..."}}' \
  | revcat apps create --file -

Update

v2 uses POST (not PATCH) at /v2/projects/{project_id}/apps/{app_id} for updates. revcat does the right thing under the hood.

# Rename
revcat apps update app_abc --name "Acme iOS (renamed)"

# Patch arbitrary fields - send any nested field as null in the JSON to clear it
revcat apps update app_abc --file ./patch.json

Sample patch.json to clear a stored shared_secret:

{ "app_store": { "shared_secret": null } }

Delete

Hard delete. Confirm prompt in interactive mode; pass -y/--confirm to skip.

revcat apps delete app_abc           # prompts
revcat apps delete app_abc --confirm # skips prompt (CI / scripts)

If the app has dependent resources (offerings, products, etc.) the API returns 409. Drain those first or back out the dependents in the dashboard.