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

# Copy Text

> Copy text to the phone's clipboard

Load text into the phone's clipboard via the iOS Shortcut. The text is staged on the server, then the copy shortcut is triggered via Switch Control so the phone picks it up and copies it to its clipboard.

This is the recommended way to input text in MCP sessions — copy the text, then tap a text field and paste.

## Request

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/copy-text \
  -H "X-API-Key: joot_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from TapKit"}'
```

### Path Parameters

| Parameter  | Type     | Description          |
| ---------- | -------- | -------------------- |
| `phone_id` | `string` | The phone identifier |

### Query Parameters

| Parameter | Type      | Default | Description                    |
| --------- | --------- | ------- | ------------------------------ |
| `async`   | `boolean` | `false` | Return immediately with job ID |

### Request Body

```json theme={null}
{
  "text": "Hello from TapKit"
}
```

| Field  | Type     | Required | Description                               |
| ------ | -------- | -------- | ----------------------------------------- |
| `text` | `string` | Yes      | The text to copy to the phone's clipboard |

## 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:02Z"
}
```

## Examples

### Python

```python theme={null}
import requests

response = requests.post(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/copy-text",
    headers={
        "X-API-Key": "joot_...",
        "Content-Type": "application/json"
    },
    json={"text": "Hello from TapKit"}
)
```

### Copy and Paste Workflow

```python theme={null}
# 1. Copy text to clipboard
requests.post(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/copy-text",
    headers={"X-API-Key": "joot_...", "Content-Type": "application/json"},
    json={"text": "Search query here"}
)

# 2. Tap the search field
requests.post(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/tap",
    headers={"X-API-Key": "joot_...", "Content-Type": "application/json"},
    json={"x": 590, "y": 120}
)

# 3. Long press to get paste option, then tap paste
requests.post(
    f"https://api.tapkit.ai/v1/phones/{phone_id}/tap-and-hold",
    headers={"X-API-Key": "joot_...", "Content-Type": "application/json"},
    json={"x": 590, "y": 120}
)
```

## Related Endpoints

* [Read Clipboard](/api-reference/phones/read-clipboard) - Read text from the phone clipboard
* [Tap](/api-reference/phones/tap) - Tap to focus a text field