Identity Primitives

Agent Mobile

Give your AI agent a virtual iPhone with an eSIM, App Store access, and biometric simulation. Install and interact with native iOS apps programmatically.

Coming soon

Agent Mobile is currently in private beta. The API surface described below reflects the planned design. Request early access from the Humiris dashboard to be notified when it launches.

Virtual iPhone with eSIM

Each agent mobile device is a virtualized iPhone instance running the latest iOS version. The device includes a provisioned eSIM for cellular connectivity, giving your agent a real mobile presence that apps and services trust.

The virtual device behaves identically to a physical iPhone. It has a unique IMEI, carrier identity, and device fingerprint. Services that require a mobile device will recognize it as genuine hardware.

bash

# Provision an agent with a mobile device (planned API)
curl -X POST https://api.humiris.com/v1/agents \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "mobile-agent",
    "identity": {
      "mobile": {
        "platform": "ios",
        "esim": true
      }
    }
  }'

# Response (planned)
{
  "mobile": {
    "device_id": "dev_m4k8x2",
    "platform": "ios",
    "version": "18.4",
    "esim_number": "+14155550198",
    "status": "provisioning"
  }
}

App Store access

Your agent can install apps from the App Store using a managed Apple ID. Humiris handles account creation, app downloads, and updates. Your agent can interact with any installed app through touch simulation and accessibility APIs.

bash

# Install an app (planned API)
curl -X POST https://api.humiris.com/v1/agents/mobile-agent/mobile/apps/install \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_id": "com.example.app",
    "app_store_id": "123456789"
  }'

# Interact with an app (planned API)
curl -X POST https://api.humiris.com/v1/agents/mobile-agent/mobile/interact \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "tap",
    "element": { "label": "Sign In" },
    "screenshot": true
  }'

Face ID and Touch ID simulation

The virtual device supports biometric authentication simulation. When an app prompts for Face ID or Touch ID, the agent can approve or deny the request programmatically. This enables your agent to use apps that require biometric authentication for login or payment confirmation.

bash

# Configure biometric simulation (planned API)
curl -X PATCH https://api.humiris.com/v1/agents/mobile-agent/mobile/config \
  -H "Authorization: Bearer hum_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "biometrics": {
      "face_id": { "enrolled": true, "auto_approve": true },
      "touch_id": { "enrolled": true, "auto_approve": true }
    }
  }'

Screenshots and screen recording

Capture screenshots or record video of the device screen at any time. This is useful for debugging, auditing agent behavior, or extracting visual information from apps that do not expose data through text.

bash

# Take a screenshot (planned API)
curl https://api.humiris.com/v1/agents/mobile-agent/mobile/screenshot \
  -H "Authorization: Bearer hum_sk_live_..." \
  --output screen.png

Next steps

While Agent Mobile is in development, use Agent Browser for web-based mobile interactions and Agent Phone for SMS and voice. Check the API Reference for the latest endpoint availability.