> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.doc-detective.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.doc-detective.com/_mcp/server.

# App surface

> Reference for the `App surface` schema.

## Referenced In

* [Click element (detailed)](/reference/schemas/click-element-detailed)
* [Find element (detailed)](/reference/schemas/find-element-detailed)
* [Type keys (detailed)](/reference/schemas/type-keys-detailed)
* [Capture screenshot (detailed)](/reference/schemas/capture-screenshot-detailed)
* [Capture screenshot fields](/reference/schemas/capture-screenshot-fields)
* [Record (detailed)](/reference/schemas/record-detailed)
* [closeSurface](/reference/schemas/closesurface)
* [Swipe (directional)](/reference/schemas/swipe-directional)
* [Swipe (point-to-point)](/reference/schemas/swipe-point-to-point)

## Fields

| Field  | Type                                                                               | Description                                                                                                                                              | Default |
| :----- | :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| app    | string                                                                             | Required. Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier). Minimum length: 1. Pattern: `\S` | —       |
| window | one of: - integer - string - object([By criteria](/reference/schemas/by-criteria)) | Optional. Which app window to act on. Omit to use the active window. Apps have windows, no tabs.                                                         | —       |

## Examples

```json
{
  "app": "example",
  "window": 42
}
```