Skip to main content
PATCH
/
apps
/
{id}
Update App
curl --request PATCH \
  --url https://api.whop.com/api/v1/apps/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "app_store_description": "<string>",
  "base_url": "https://example.com/path",
  "dashboard_path": "<string>",
  "description": "<string>",
  "discover_path": "<string>",
  "experience_path": "<string>",
  "icon": {
    "direct_upload_id": "<string>",
    "id": "<string>"
  },
  "name": "<string>",
  "required_scopes": [
    "<string>"
  ],
  "status": "live"
}'
{
  "id": "app_xxxxxxxxxxxxxx",
  "name": "<string>",
  "description": "<string>",
  "status": "live",
  "base_url": "https://example.com/path",
  "domain_id": "<string>",
  "verified": true,
  "experience_path": "<string>",
  "discover_path": "<string>",
  "dashboard_path": "<string>",
  "requested_permissions": [
    {
      "permission_action": {
        "action": "<string>",
        "name": "<string>"
      },
      "is_required": true,
      "justification": "<string>"
    }
  ],
  "stats": {
    "dau": 42,
    "mau": 42,
    "time_spent_last24_hours": 42,
    "wau": 42
  },
  "api_key": {
    "id": "<string>",
    "token": "<string>",
    "created_at": 1701406800
  }
}

Authorizations

​
Authorization
string
header
required

The app API key from an app from the /dashboard/developer page

Path Parameters

​
id
string
required
Example:

"app_xxxxxxxxxxxxxx"

Body

application/json

Parameters for UpdateApp

​
app_store_description
string | null

The description of the app for the app store in-depth app view.

​
base_url
string | null

The base production url of the app

Example:

"https://example.com/path"

​
dashboard_path
string | null

The path for the dashboard view of the app

​
description
string | null

The description of the app

​
discover_path
string | null

The path for the discover view of the app

​
experience_path
string | null

The path for the hub view of the app

​
icon
object | null

The icon for the app

​
name
string | null

The name of the app

​
required_scopes
(string | null)[] | null

The scopes that the app will request off of users when a user installs the app.

​
status
enum<string> | null

If the status is live, the app is visible on Whop discovery. In order to be live, you need to set the name, icon, and description. Being unlisted or hidden means it's not visible on Whop but you can still install the app via direct link. To remove the app from whop discovery, you should set the status to unlisted. The status of an experience interface

Available options:
live,
unlisted,
hidden

Response

A successful response

An object representing an app

​
id
string
required

The ID of the app

Example:

"app_xxxxxxxxxxxxxx"

​
name
string
required

The name of the app

​
description
string | null
required

The description of the app

​
status
enum<string> | null
required

If the status is live, the app is visible on Whop discovery. In order to be live, you need to set the name, icon, and description. Being unlisted or hidden means it's not visible on Whop but you can still install the app via direct link. To remove the app from whop discovery, you should set the status to unlisted. The status of an experience interface

Available options:
live,
unlisted,
hidden
​
base_url
string | null
required

The base url of the app

Example:

"https://example.com/path"

​
domain_id
string
required

The unique part of the proxied domain for this app. Used to generate the base url used to display the app inside the whop platform. Refers to the id part in the final url: https://{domain_id}.apps.whop.com

​
verified
boolean
required

Whether this app has been verified by Whop. Verified apps are endorsed by whop and are shown in the 'featured apps' section of the app store.

​
experience_path
string | null
required

The path part for a specific view of the app. This is the template part of the url after the base domain. Eg: /experiences/[experienceId]

​
discover_path
string | null
required

The path part for a specific view of the app. This is the template part of the url after the base domain. Eg: /experiences/[experienceId]

​
dashboard_path
string | null
required

The path part for a specific view of the app. This is the template part of the url after the base domain. Eg: /experiences/[experienceId]

​
requested_permissions
object[]
required

The set of permissions that an app requests to be granted when a user installs the app.

​
stats
object | null
required

A collection of stats for the app.

​
api_key
object | null
required

The API key for the app