> ## 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.

# Select Phone

> Switch the active phone on the Mac

Tell the Mac app to switch its active phone and enable Switch Control for it. Use this when a Mac has multiple phones connected and you want to control a specific one.

## Request

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/select \
  -H "X-API-Key: joot_your_api_key"
```

### Path Parameters

| Parameter  | Type     | Description                   |
| ---------- | -------- | ----------------------------- |
| `phone_id` | `string` | The phone to select as active |

## Response

**Status: 200 OK**

```json theme={null}
{
  "id": "job_abc123",
  "status": "completed",
  "result": {},
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:30:01Z"
}
```

## Examples

### Python

```python theme={null}
import requests

# List phones to find the one you want
phones = requests.get(
    "https://api.tapkit.ai/v1/phones",
    headers={"X-API-Key": "joot_..."}
).json()

# Select a specific phone
target = next(p for p in phones if p["name"] == "iPhone 15 Pro")

requests.post(
    f"https://api.tapkit.ai/v1/phones/{target['id']}/select",
    headers={"X-API-Key": "joot_..."}
)
```

## Related Endpoints

* [List Phones](/api-reference/phones/list-phones) - List all available phones
* [Get Phone Status](/api-reference/phones/get-status) - Check if the phone is ready
* [Get Info](/api-reference/phones/get-info) - Get device metadata