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

# Use cases

> Step-by-step flows for posting a video from your own account, handing a task to the phone agent and checking a screen on a real device.

These flows use only what Phones supports today. Each one lists the actions in order, so you can run it from an AI assistant, from your own code or with the phone agent.

***

## Post a video to TikTok or Instagram from your own account

The post comes from a real phone that is signed in to your own account.

**Before you start**

* An Android phone, unlocked, with the TikTok or Instagram app installed and signed in. Pushing media works on Android only. On an iPhone, put the video in the gallery yourself and start at step 2.
* A link to the video file. For a UGC clip made in Appeeky, read the clip with `GET /v1/ugc/clips/:clipId` and use its `videoUrl`. These links are short-lived, so fetch one right before you push. See [Personas and clips](https://docs.appeeky.com/docs/ugc-personas-and-clips.md).

**1. Copy the video to the phone**

Run `push_media` with the link. The video lands in the phone's gallery.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://api.appeeky.com/v1/phones/invoke \
  -H "X-API-Key: $APPEEKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "invocation": { "method": "push_media", "url": "https://example.com/clip.mp4" } }'
```

**2. Open the app**

Run `list_apps` to find the app's id, then `open_app` with it.

**3. Walk to the post screen**

Repeat observe, then tap: start a new post, pick the newest video from the gallery, continue to the caption screen. Each tap returns the next screen.

**4. Write the caption**

Tap the caption field, then run `type` with the caption text.

**5. Tap Post and approve**

The tap on **Post** or **Share** pauses. Open **`/dashboard/phones`**, check the screenshot and the caption, and choose **Approve**. The post goes out.

With an AI assistant connected to the [Appeeky MCP server](https://docs.appeeky.com/docs/mcp.md), the same flow is one prompt:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Copy my latest approved UGC clip to my Pixel and post it on TikTok with its caption.
```

The assistant calls the `phone_*` tools step by step and stops at the Post button until you approve.

***

## Hand the whole task to the phone agent

When the media is already in the gallery, let the [phone agent](https://docs.appeeky.com/docs/phones/phone-agent.md) do the walking. Push the video first, because the agent itself can't push media.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -N -X POST https://api.appeeky.com/v1/phones/agent \
  -H "X-API-Key: $APPEEKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "task": "Open Instagram and post the newest video in the gallery with the caption: Week 3 and still going" }'
```

Watch the steps in the stream, or run the same task from the **Agent** panel in Appeeky Desktop and watch the phone in the live view. Approve the final tap on the **Phones** page.

***

## Check a screen on a real device

`observe` returns a real screenshot from a real phone, so an agent can look at things that only exist on a device: how your app looks after an update, or which screen a flow ends on.

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Open my app on the phone, go to the paywall and describe what you see.
```

The assistant opens the app, taps through with `phone_tap` and reads each screen. Nothing in this flow needs approval unless a button it taps is labelled like Buy or Subscribe.

***

## Tips for reliable runs

* Unlock the phone and keep the screen on before you start.
* Sign in to the apps yourself. Agents never enter passwords or codes you didn't give them.
* Name the app, the media and the exact caption.
* Stay close to the dashboard or your email. An approval expires after 10 minutes.
* Keep an eye on the rate limit in long sessions: 30 actions per minute and 600 per hour for each phone.


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