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
Open an app by name. Uses Spotlight search to find and launch the app.

​
Request

curl -X POST https://api.tapkit.ai/v1/phones/{phone_id}/open-app \
  -H "X-API-Key: TK_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: TK_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"app_name": "Settings"}'

{
  "job_id": "abc123"
}