> ## Documentation Index
> Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webdev Cards

> Every card that the Webdev Addon sends through the Manus API: when it appears, its fields, how to answer it, and how the Manus web app shows the same step

<sup>Questions or issues? Contact us at [api-support@manus.ai](mailto:api-support@manus.ai).</sup>

The Webdev Addon builds websites, mobile apps, and games. This page lists every card that it sends through the Manus API. Read [Addon Interaction Cards](https://open.manus.ai/docs/v2/task-lifecycle/addon-interaction-cards) first. That page has the general rules for reading, rendering, and answering cards. This page only adds what is specific to each Webdev `card_type`.

Each section has a screenshot of the same step in the Manus web app. The screenshots are a reference for what the step means to the user. You do not have to copy the design. Render the card from its fields, as described in [Render the card](https://open.manus.ai/docs/v2/task-lifecycle/addon-interaction-cards#render-the-card).

The examples use sample data in production formats. Some come from test tasks, with long text shortened and translated.

Rules for all Webdev cards:

* Field names, `card_type` values, and option `const` values are stable. `title`, `message`, and option `title` text can change, and they are in the user's language when the agent writes them. Show them as given. Do not match on them.
* Option `const` values such as `feature_0` or `style_1` only identify an option on this card. Do not store them across cards.
* For a form card, `card_id` is the Webdev operation ID, which starts with `wdo_`. For a checkpoint card, it is `checkpoint:<version_id>`.

## Summary

The Deadline column shows `expiry_action`, which says what the Addon does at `expires_at`. With `accept_default`, the Addon confirms the defaults. With `cancel`, the Addon cancels the step.

| `card_type` | `kind` | Agent waits | Deadline | The user |
| - | - | - | - | - |
| [webdev.blueprint](#project-blueprint) | `elicitation` | Yes | `accept_default` | Confirms the features and design direction of a new project. |
| [webdev.secret](#secrets) | `elicitation` | Yes | No | Enters the secrets (environment variables) that the project needs. The card has `sensitive: true`. |
| [webdev.hosting\_confirmation](#reserved-hosting) | `elicitation` | Yes | `cancel` when `expires_at` is present | Accepts or declines a switch to Reserved hosting. |
| [webdev.publish\_confirmation](#publish-approval) | `elicitation` | Yes | `cancel` when `expires_at` is present | Allows publishing the latest version once, always allows it, or declines. Websites skip this card by default. |
| [webdev.visibility\_confirmation](#visibility-change) | `elicitation` | Yes | `cancel` when `expires_at` is present | Accepts or declines a change of who can see the published website. |
| [webdev.checkpoint](#checkpoint) | `info` | No | No | Sees that Manus saved a new version of the project. |
| [webdev.unsupported\_step](#unsupported-step) | `info` | No | No | Sees that a step is not available through the Manus API. The agent continues without it. |

The Webdev Addon sends no other card types.

## Manus web cards and their API cards

The Manus web app shows more Webdev cards than the Manus API. This table shows what your client receives for each Manus web card.

| Card in the Manus web app | What your client receives |
| - | - |
| Project blueprint (website or mobile app) | `webdev.blueprint` |
| Game blueprint (gameplay and concept art) | `webdev.unsupported_step` with the step name "This step". The agent continues with its own plan. |
| Agent mode choice | `webdev.unsupported_step` ("Choosing the agent mode") |
| Add project secret | `webdev.secret` for the project owner. Other users get `webdev.unsupported_step` ("Entering secrets (project owner only)"). |
| Reserved hosting ("Need your website always on?") | `webdev.hosting_confirmation` for the project owner. Other users get `webdev.unsupported_step` ("Confirming hosting (project owner only)"). |
| Publish approval ("Allow Manus to publish?"): games and mobile apps by default, and websites only when the user turned off Agent Publish | `webdev.publish_confirmation`. For a project migrated from an earlier Manus website version: `webdev.unsupported_step` ("Publishing this project"). |
| Visibility change | `webdev.visibility_confirmation`. If the Addon cannot describe the change: `webdev.unsupported_step` ("This step"). |
| Publication result ("Website published!", with the website URL and a visibility selector): websites publish this way by default, without an approval card | No card. To change who can see the website, the user asks the agent. If the change widens access, the user gets `webdev.visibility_confirmation`. |
| Saved version (checkpoint project card) | `webdev.checkpoint` |
| Sync with GitHub (create a repository) | `webdev.unsupported_step` ("Creating a GitHub repository") |
| Disconnect GitHub | `webdev.unsupported_step` ("Disconnecting GitHub") |
| Connect Stripe | `webdev.unsupported_step` ("Connecting Stripe") |
| Set up Shopify | `webdev.unsupported_step` ("Setting up Shopify") |
| Claim the Shopify store | `webdev.unsupported_step` ("Claiming the Shopify store") |

## Project blueprint

`card_type`: `webdev.blueprint`

**When:** After the agent creates a new website or mobile app project and before it builds the project. The agent waits for the answer.

The Manus web app shows the feature plan first, as in this screenshot, and the design direction choices next.

![Project blueprint card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/blueprint.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=b714058e53ef81873ce83f2efe2ae701)

**Fields:** `elicitation.requestedSchema.properties` has these properties:

| Property | Type | Description |
| - | - | - |
| `features` | array of option IDs (`items.anyOf`) | The features to build. Required. `minItems` is 1. `default` selects all features. |
| `style` | option ID (`oneOf`) | The design direction. Required when present. `style_0` is "Inspire Me": Manus chooses. `default` is the recommended style. |
| `powerUps` | array of option IDs (`items.anyOf`) | Optional enhancements. Present only when the plan has power-ups, and not in `required`. Option IDs look like `power_up_0`. `default` lists the ones that Manus recommends. |

Property names are case-sensitive: write `powerUps`, not `power_ups`. Only the option IDs use underscores.

`elicitation.message` is the project brief. Show it above the fields.

**Answers:**

| `action` | Result |
| - | - |
| `accept` | Manus builds the project with the selected features, style, and power-ups. |
| `decline` or `cancel` | "Skip all": Manus builds the project with the default plan. |
| (no answer by `expires_at`) | The Addon confirms the defaults. |

Example card:

```json theme={null}
{
  "event_id": "yCFhTsl3GhfaE5q75zLAT9",
  "card_id": "wdo_bc47f8392b306be03b3e64e9",
  "card_type": "webdev.blueprint",
  "kind": "elicitation",
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Project blueprint: Checkpoint Bakery",
  "expires_at": "1793695279370",
  "expiry_action": "accept_default",
  "elicitation": {
    "mode": "form",
    "message": "Build a minimal one-page website for Checkpoint Bakery.",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "features": {
          "type": "array",
          "title": "Features",
          "description": "Features to build. Keep at least one.",
          "minItems": 1,
          "maxItems": 2,
          "items": {
            "anyOf": [
              { "const": "feature_0", "title": "One-page site with the bakery name and a short intro" },
              { "const": "feature_1", "title": "Save a checkpoint after the page is built" }
            ]
          },
          "default": ["feature_0", "feature_1"]
        },
        "style": {
          "type": "string",
          "title": "Design direction",
          "oneOf": [
            { "const": "style_0", "title": "Inspire Me: One less decision. Let Manus choose." },
            { "const": "style_1", "title": "Morning paper bag: warm kraft and cream tones." }
          ],
          "default": "style_0"
        }
      },
      "required": ["features", "style"]
    }
  }
}
```

Example `input`:

```json theme={null}
{ "action": "accept", "content": { "features": ["feature_0", "feature_1"], "style": "style_1" } }
```

## Secrets

`card_type`: `webdev.secret`

**When:** The project needs secrets, for example an API key, and the user is the project owner. The agent waits for the answer.

![Add project secret card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/secret.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=8c91fcd7330584960ea983fdfb8138dc)

**Fields:** One `string` property per secret. The property name is the environment variable name, for example `BAKERY_API_KEY`. `title` is the display name, `description` is optional, and `maxLength` is 4096. Secrets in `required` must have a value. The card has no `default` values.

The card has `sensitive: true`. Follow [Sensitive cards](https://open.manus.ai/docs/v2/task-lifecycle/addon-interaction-cards#sensitive-cards): use password inputs, and do not log or show the values again.

**Answers:**

| `action` | Result |
| - | - |
| `accept` | Manus stores the values encrypted in the project. The agent never sees them. `content` may only contain the properties of this card. |
| `decline` or `cancel` | No secret is saved. The agent continues without it. |

Example card:

```json theme={null}
{
  "event_id": "Eh9ZxgbYQQJP7ngoY45sME",
  "card_id": "wdo_3a45f1e68ab33ae4ff770fba",
  "card_type": "webdev.secret",
  "kind": "elicitation",
  "sensitive": true,
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Enter secrets",
  "elicitation": {
    "mode": "form",
    "message": "The project needs these secrets. Values are stored encrypted in the project and are never shown to the agent.",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "BAKERY_API_KEY": {
          "type": "string",
          "title": "BAKERY_API_KEY",
          "description": "Required API key for the Secret Bakery website.",
          "maxLength": 4096
        }
      },
      "required": ["BAKERY_API_KEY"]
    }
  }
}
```

Example `input`:

```json theme={null}
{ "action": "accept", "content": { "BAKERY_API_KEY": "the-value-the-user-entered" } }
```

## Reserved hosting

`card_type`: `webdev.hosting_confirmation`

**When:** The agent proposes to switch the project to Reserved hosting, and the user is the project owner. Reserved hosting keeps the website always on and supports background jobs and persistent connections. The agent waits for the answer.

![Reserved hosting card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/hosting-confirmation.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=2f65643371c8a85fb59f63125b564ced)

**Fields:** None. `requestedSchema.properties` is empty. Render the message with an accept button and a decline button.

**Answers:**

| `action` | Result |
| - | - |
| `accept` | Manus switches the project to Reserved hosting. Send `content: {}` or omit `content`. |
| `decline` or `cancel` | The project keeps its current hosting. |

Example card:

```json theme={null}
{
  "event_id": "Tq7LmZ2vXc9RbN4kHs1JdW",
  "card_id": "wdo_6c1e9a47f03b28d5e4a9c712",
  "card_type": "webdev.hosting_confirmation",
  "kind": "elicitation",
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Switch to Reserved hosting",
  "elicitation": {
    "mode": "form",
    "message": "Reserved hosting keeps the website always on and supports background jobs and persistent connections. Choose decline to keep the current hosting.",
    "requestedSchema": { "type": "object", "properties": {} }
  }
}
```

## Publish approval

`card_type`: `webdev.publish_confirmation`

**When:** The agent wants to publish the latest version of the project, and the project does not let the agent publish without asking. By default, games and mobile apps ask, and websites do not. A website asks only if the user turned off Agent Publish in the project settings. The agent waits for the answer.

For example, the Manus web app shows this approval card for a game:

![Publish approval card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/publish-confirmation.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=fa44cd8697502b913fc243aa4e98de16)

By default, a website publishes without this card. The Manus web app then shows a publication result card with the website URL and a visibility selector. Your client gets no card for this step. To change who can see the website, the user asks the agent. If the change widens access, the user gets a [Visibility change](#visibility-change) card.

![Publication result card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/publish-result.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=81d1ebbeaa9028b6f5cd2d893f53cf4d)

**Fields:**

| Property | Type | Description |
| - | - | - |
| `mode` | option ID (`oneOf`) | Required. `allow_once`: publish this time. `always_allow`: publish now and do not ask again for this project. `default` is `allow_once`. |

**Answers:**

| `action` | Result |
| - | - |
| `accept` | Manus publishes the latest version. With `always_allow`, Manus also publishes this project without asking next time. |
| `decline` or `cancel` | Manus does not publish. |

Example card:

```json theme={null}
{
  "event_id": "Pz3NcV8qWe5TyK1mUa6GhR",
  "card_id": "wdo_9f2d4b81c6e07a35b1d8e046",
  "card_type": "webdev.publish_confirmation",
  "kind": "elicitation",
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Publish the project",
  "elicitation": {
    "mode": "form",
    "message": "The agent wants to publish the latest version of this project.",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "title": "Publish option",
          "oneOf": [
            { "const": "allow_once", "title": "Publish this time" },
            { "const": "always_allow", "title": "Always publish without asking" }
          ],
          "default": "allow_once"
        }
      },
      "required": ["mode"]
    }
  }
}
```

Example `input`:

```json theme={null}
{ "action": "accept", "content": { "mode": "allow_once" } }
```

## Visibility change

`card_type`: `webdev.visibility_confirmation`

**When:** The agent wants to widen who can see the published website, for example from only the owner to everyone. The agent waits for the answer.

![Visibility change card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/visibility-confirmation.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=ccb44c6be63782ec071ab40f214a48c8)

**Fields:** None. `elicitation.message` says the new and the current visibility. Render the message with an accept button and a decline button.

**Answers:**

| `action` | Result |
| - | - |
| `accept` | Manus changes the visibility of the website. Send `content: {}` or omit `content`. |
| `decline` or `cancel` | The website keeps its current visibility. |

Example card:

```json theme={null}
{
  "event_id": "Hb5RxJ9sLd2QwE7pYc4MnF",
  "card_id": "wdo_3e8a0c5d71f49b26c0a7d913",
  "card_type": "webdev.visibility_confirmation",
  "kind": "elicitation",
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Change website visibility",
  "elicitation": {
    "mode": "form",
    "message": "The agent wants to make the published website visible to everyone (now: only you). Choose decline to keep the current visibility.",
    "requestedSchema": { "type": "object", "properties": {} }
  }
}
```

## Checkpoint

`card_type`: `webdev.checkpoint`

**When:** Manus saved a new version (checkpoint) of the project. The agent does not wait. If the same version is reported again, the card has the same `card_id`. Show it once.

![Checkpoint project card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/checkpoint.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=cbf32d8df9a99665cc9297b21dcf5504)

`info.message` describes the saved version. `info.data` has these fields:

| Field | Description |
| - | - |
| `resource_uri` | The saved version, as a `manus-resource://manus-webdev/project/<project_id>?v=<version_id>` URI. |
| `version_id` | The Git commit SHA of the saved version. The card's `card_id` is `checkpoint:<version_id>`. |
| `platform` | `web`, `mobile`, or `game`. |
| `checkpoint_id` | Optional. The Webdev checkpoint record ID. |
| `created_at` | Optional. When the checkpoint was saved, in ISO 8601 format. |

The card can carry a screenshot of the project at this exact version in `display.media[0]`, with `id: "screenshot"`, `type: "image"`, an `https` `url`, and `alt` text. The URL is a signed read URL that stays valid for at least 7 days. Copy the image if you need to keep it longer. If no screenshot is ready when the card is sent, the card has no `display`. The card is complete without it. The Manus web app shows the screenshot as the cover of the card.

[Info cards](https://open.manus.ai/docs/v2/task-lifecycle/addon-interaction-cards#info-cards) has a full example.

## Unsupported step

`card_type`: `webdev.unsupported_step`

**When:** The agent reached a step that is not available through the Manus API. The [table above](#manus-web-cards-and-their-api-cards) lists these steps. The agent does not wait. It continues without the step.

For example, the Manus web app shows this card to create a GitHub repository. Your client receives `webdev.unsupported_step` instead:

![Sync with GitHub card in the Manus web app](https://mintcdn.com/manus-api/2W_uZCH-hPVx3pFq/images/screenshot/webdev-cards/github-create.png?fit=max\&auto=format\&n=2W_uZCH-hPVx3pFq\&q=85\&s=6a9d02a0d17f5f9504064d323ca91fde)

Show `title` and `info.message`. Do not call `task.confirmAction` for this card.

Example card:

```json theme={null}
{
  "event_id": "vx4qp5VSezxYGuoShcKJGi",
  "card_id": "wdo_afec8ac4f4866f3885075c77",
  "card_type": "webdev.unsupported_step",
  "kind": "info",
  "addon": { "id": "manus-webdev", "display_name": "Webdev" },
  "title": "Creating a GitHub repository is not available here",
  "info": {
    "message": "Creating a GitHub repository cannot be completed through the Manus API, so the agent continues without it."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.