Remix an app

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Creates a copy of an app in your workspace and makes you its owner. The app must be in the workspace your personal access token is scoped to, and the remix is created there too, so you need an editor-capable role in it. You can remix an app you own, collaborate on as an editor, or administer as a workspace admin, an approved template, or an app its owner marked as remixable and didn't make private. Remixing a paid template requires that you bought it first. Call Get remix requirements first to see which secrets the app needs.

The remix is named after the app with (Copy) appended. When the app is an approved template, the remix copies the approved version of the template, name included, rather than the app's current state, unless you set with_chat_history.

The body takes only the fields below. Fields that Create app accepts, such as name, user_description, public_settings, custom_instructions, and prevent_iframe_embedding, are ignored here. The remix copies user_description, public_settings, and custom_instructions from the app and starts with prevent_iframe_embedding set to true. Rename the remix or change its description afterwards with Update app. The API has no endpoint for changing the other settings yet.

The response returns as soon as the new app exists. Setting up its files can continue in the background, so poll Get app until its status.state is no longer processing. A token limited to selected apps doesn't gain access to the new app, so use a token with access to all apps in the workspace if you need to reach the remix afterwards. This endpoint is limited to 10 requests per minute.

<Warning>The new app is created before secret_values are applied and before the code is copied. A request that fails at either step, for example on an invalid secret_values entry, still leaves the new app in your workspace, and it counts toward your plan's app limit. Delete it before you retry.</Warning>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.</Warning>

{
  "secret_values": {
    "STRIPE_API_KEY": {
      "type": "value",
      "value": "sk_test_example"
    },
    "SENDGRID_API_KEY": {
      "type": "clone"
    }
  }
}

{
  "id": "6820f3a4e7b91d003c45a1f2",
  "name": "My CRM",
  "slug": "my-crm-3c45a1f2",
  "user_description": "A CRM to track leads and deals",
  "created_by": "developer@example.com",
  "created_date": "2026-08-01T09:15:00",
  "updated_date": "2026-08-02T14:30:00",
  "status": {
    "state": "ready",
    "details": "Publishing app",
    "request_id": "a1b2c3d4e5f67890abcdef12",
    "last_updated_date": "2026-08-02T14:30:00Z",
    "error_source": "build",
    "paywall_context": {
      "billing_organization_id": "67e0b12c4d8a3f005b21c9e4",
      "user_id": "6706af53b9c1e2004a37d85f",
      "evaluated_at": "2026-08-02T14:30:00Z"
    }
  },
  "last_deployed_at": "2026-08-02T14:30:00",
  "screenshot_url": "https://storage.base44.com/screenshots/6820f3a4e7b91d003c45a1f2.png",
  "preview_screenshot_url": "https://storage.base44.com/previews/6820f3a4e7b91d003c45a1f2.png"
}