Skip to main content
POST
/
v1
/
phones
/
{phone_id}
/
open-app
Open App
curl --request POST \
  --url https://api.example.com/v1/phones/{phone_id}/open-app

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 an app by name. TapKit resolves the requested app against the Mac app’s installed app list and launches it on the phone.

​
Request

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

{
  "app_name": "Settings"
}
FieldTypeDescription
app_namestringName of the app to open

​
Async Mode

Append ?async=true to return immediately with a job ID: 
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"}'

{
  "job_id": "abc123"
}