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

# Open App

> Open an app by name

Open an app by name. TapKit resolves the requested app against the Mac app's installed app list and launches it on the phone.

## Request

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/open-app \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"app_name": "Settings"}'
```

### Request Body

```json theme={null}
{
  "app_name": "Settings"
}
```

| Field      | Type     | Description             |
| ---------- | -------- | ----------------------- |
| `app_name` | `string` | Name of the app to open |

### Async Mode

Append `?async=true` to return immediately with a job ID:

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/open-app?async=true \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"app_name": "Settings"}'
```

```json theme={null}
{
  "job_id": "abc123"
}
```