--- title: NativeBridge API Integration on Truto slug: nativebridge category: Application Development canonical: "https://truto.one/integrations/detail/nativebridge/" --- # NativeBridge API Integration on Truto **Category:** Application Development **Status:** Beta ## MCP-ready AI tools Truto exposes 10 tools for NativeBridge that AI agents can call directly. - **list_all_native_bridge_devices** — List available devices in NativeBridge. Returns: id, type, osVersion, modelName, isEmulator, userPlan, magicLink, accessType, version. - **create_a_native_bridge_application** — Upload an Android application (APK or AAB) to NativeBridge from a file or public URL and generate a shareable magic link. Returns the uploaded app summary including id, magicLink, accessType, and version. Requires either file or apkUrl; if both are supplied, file takes precedence. - **list_all_native_bridge_applications** — List all applications uploaded by the authenticated user in NativeBridge. Returns each application with id, name, packageName, version, magicLink, access_type, and more. No parameters required. - **create_a_native_bridge_device_session** — Create a new Android device session in NativeBridge, optionally launching a specific APK. Returns: sessionId, sessionUrl, message, id, magicLink, accessType, version. Required: deviceId. - **get_single_native_bridge_session_by_id** — Get details of a NativeBridge session by id. Returns: id, magicLink, accessType, version. Required: id. - **delete_a_native_bridge_session_by_id** — Delete a NativeBridge session by id. Returns an empty 204 response on success. Required: id. - **list_all_native_bridge_projects** — List all your NativeBridge projects. Returns: id, magicLink, accessType, version. - **create_a_native_bridge_project** — Create a new test project in NativeBridge. Returns: id, magicLink, accessType, version. - **list_all_native_bridge_project_files** — List files and folders in a NativeBridge project. Returns: id, magicLink, accessType, version. Required: project_id. - **create_a_native_bridge_project_import** — Import an application into a nativebridge project. Returns the imported app record including id, magicLink, accessType, and version. Required: project_id. ## How it works 1. **Link your customer's NativeBridge account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach NativeBridge.** The Proxy API is a 1-to-1 mapping of the NativeBridge API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed live mobile app previews in no-code builders** — No-code and low-code mobile builders can let users preview their compiled iOS/Android apps directly in the browser without leaving the dashboard. Truto handles the NativeBridge auth and session lifecycle so your platform can focus on the build-to-preview flow. - **Attach reproducible mobile bug sessions to tickets** — Issue trackers and QA platforms can generate a live device session for the exact APK/AAB tied to a bug report and attach the Magic Link to the ticket. Developers reproduce mobile bugs in one click instead of provisioning devices locally. - **Broadcast build previews to reviewers in CI/CD tools** — DevOps and collaboration platforms can automatically ingest new mobile builds into a NativeBridge project and push the shareable session link to reviewers. Product managers and clients approve mobile iterations without installing anything. - **Orchestrate cloud device sessions for automated test runs** — Test automation and QA orchestration platforms can programmatically provision devices matching specific OS versions or models, run tests against the session, and tear down sessions to control concurrency and cost. - **Maintain multi-version app history for client QA portals** — Agencies and client-facing QA platforms can organize their customers' app builds under NativeBridge projects and import new versions on each release. End users get a browsable history of testable app versions per client. ## What you can build - **One-click mobile app preview links** — Upload an APK or AAB via the NativeBridge application endpoint and surface the returned Magic Link inside your product's UI. - **In-app embedded device emulator** — Create a device session and embed the returned session URL in an iframe so users interact with their native mobile app inside your web dashboard. - **Device targeting selector** — List available NativeBridge devices and let users pick target OS version, model, or emulator vs. real hardware before launching a session. - **Session lifecycle controls** — Poll session status by ID and expose a delete action so users can monitor active sessions and free up concurrency limits from within your product. - **Project-based build history** — Create NativeBridge projects per customer or app, import new builds on each release, and list project files to render a version timeline. - **Automated build-to-review workflows** — Trigger an application upload and device session creation as part of your CI/CD flow, then post the resulting Magic Link into review channels. ## FAQs ### How does Truto handle authentication with NativeBridge? Truto manages the NativeBridge credentials your end users provide and injects them into every API call. Your product never has to store or rotate NativeBridge API keys directly. ### What NativeBridge operations are supported today? The current toolkit covers applications (create and list), device sessions (create, get by ID, delete), device discovery (list), and projects (create, list, list files, create import). Additional endpoints can be added on request. ### Can I upload an APK or AAB through the integration? Yes. The create application tool ingests an APK or AAB (typically via a public URL or file reference) and returns the NativeBridge application ID plus the shareable Magic Link. ### Can end users choose which device their app runs on? Yes. Use the list devices tool to fetch available environments, then pass the selected device into the create device session tool to launch the app on that specific OS version, model, or emulator/real-device target. ### How do we manage concurrency and clean up idle sessions? You can poll session state using the get session by ID tool and programmatically remove sessions with the delete session tool. This lets you enforce your own concurrency and cost limits per customer. ### Is there a unified API for this integration? NativeBridge is exposed today through direct tool calls rather than a unified API, since it's a specialized mobile app hosting category. You interact with it through Truto's Passthrough and tool-call interfaces using a consistent auth and request model. ## Related reading - [Connect NativeBridge to ChatGPT: Run Android Sessions via MCP](https://truto.one/blog/connect-nativebridge-to-chatgpt-run-android-sessions-and-apps/) — Learn how to connect NativeBridge to ChatGPT using a managed MCP server. Execute Android sessions, manage APK uploads, and orchestrate device testing via AI. - [Connect NativeBridge to Claude: Manage cloud devices and projects](https://truto.one/blog/connect-nativebridge-to-claude-manage-cloud-devices-and-projects/) — Learn how to connect NativeBridge to Claude via a managed MCP server. Automate Android app deployments, test sessions, and cloud device orchestration using AI. - [Connect NativeBridge to AI Agents: Orchestrate Mobile App Testing](https://truto.one/blog/connect-nativebridge-to-ai-agents-orchestrate-mobile-app-testing/) — Learn how to connect NativeBridge to AI Agents using Truto's /tools endpoint. Build autonomous mobile testing workflows, provision emulators, and handle binary uploads without manual API coding.