---
title: "Open a deep link"
method: POST
path: "/devices/{deviceId}/apps/open-deep-link"
tags: ["Tools/Apps"]
---

# Open a deep link

`POST /devices/{deviceId}/apps/open-deep-link`

Opens a deep link on the device. On Android the link is dispatched as an intent — packageName optionally pins it to a specific app and action overrides the default android.intent.action.VIEW. On iOS the URL is opened directly and the optional fields must be omitted. Protected packages are rejected.

## Path parameters

- `deviceId` string, required

## Headers

- `X-Device-Display-ID` integer

## Request body

- OpenDeepLinkArgs
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `action` string — Android only: intent action to dispatch. Defaults to android.intent.action.VIEW.
  - `bundleId` string — Reserved for targeting a specific iOS app; currently rejected as unsupported.
  - `deepLink` string, required — Deep link to open (e.g. myapp://path or https://example.com/path)
  - `packageName` string — Android only: package to receive the intent (e.g. com.example.app). Omit to let the system pick the handler.

## Response `204`

No Content

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)