Mobilerun · Schema

TaskCreate

Mobile AutomationCloud PhonesAI AgentsDevice FleetTestingResidential IP

Properties

Name Type Description
llmModel string The LLM model identifier to use for the task (e.g. 'mobilerun/mobile-agent-fast'). When omitted with reasoning=false, the fast-mode default model is used.
task string
maxSteps integer
temperature number Deprecated and ignored. Sampling behavior is controlled by the model provider.
reasoning boolean
accessibility boolean
vision boolean
executionTimeout integer Maximum agent execution time in seconds (1–2700).
credentials array
apps array
files array
outputSchema object
vpnCountry object
subagentModel string LLM model used by sub-agent roles: executor, app_opener, structured_output
stealth boolean Deprecated: use humanize. Both names must agree when supplied together.
continueOnFailure boolean
recordingEnabled boolean Record device video for the whole task and persist a retrievable reference
deviceId string The ID of the device to run the task on.
displayId integer The display ID of the device to run the task on.
systemPrompt object Optional custom behavioral overlay applied on top of the agent's default system prompts. Never echoed back in responses or errors.
humanize boolean Request human-like input where supported by the device. Replaces the deprecated stealth field; both must agree when supplied together.
internal boolean Mark a task started by an agent or worker on the user's behalf. It is listed as source='agent' (excluded from source='api' lists) and its events carry internal=true so user-facing notifications and we
View JSON Schema on GitHub

JSON Schema

mobilerun-ai-task-create-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/mobilerun-ai/json-schema/mobilerun-ai-task-create-schema.json",
  "title": "TaskCreate",
  "x-generated": "2026-11-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mobilerun-ai-openapi.json#/components/schemas/TaskCreate",
  "properties": {
    "llmModel": {
      "type": "string",
      "title": "Llmmodel",
      "description": "The LLM model identifier to use for the task (e.g. 'mobilerun/mobile-agent-fast'). When omitted with reasoning=false, the fast-mode default model is used.",
      "default": "mobilerun/mobile-agent-fast"
    },
    "task": {
      "type": "string",
      "minLength": 1,
      "title": "Task"
    },
    "maxSteps": {
      "type": "integer",
      "title": "Maxsteps",
      "default": 100
    },
    "temperature": {
      "type": "number",
      "title": "Temperature",
      "description": "Deprecated and ignored. Sampling behavior is controlled by the model provider.",
      "default": 0.5,
      "deprecated": true
    },
    "reasoning": {
      "type": "boolean",
      "title": "Reasoning",
      "default": false
    },
    "accessibility": {
      "type": "boolean",
      "title": "Accessibility",
      "default": true
    },
    "vision": {
      "type": "boolean",
      "title": "Vision",
      "default": false
    },
    "executionTimeout": {
      "type": "integer",
      "maximum": 2700,
      "minimum": 1,
      "title": "Executiontimeout",
      "description": "Maximum agent execution time in seconds (1–2700).",
      "default": 1000
    },
    "credentials": {
      "items": {
        "$ref": "#/$defs/PackageCredentials"
      },
      "type": "array",
      "title": "Credentials"
    },
    "apps": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Apps"
    },
    "files": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Files"
    },
    "outputSchema": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Outputschema"
    },
    "vpnCountry": {
      "anyOf": [
        {
          "$ref": "#/$defs/VPNCountry"
        },
        {
          "type": "null"
        }
      ]
    },
    "subagentModel": {
      "type": "string",
      "title": "Subagentmodel",
      "description": "LLM model used by sub-agent roles: executor, app_opener, structured_output",
      "default": "mobilerun/mobile-agent-fast"
    },
    "stealth": {
      "type": "boolean",
      "title": "Stealth",
      "description": "Deprecated: use humanize. Both names must agree when supplied together.",
      "default": false,
      "deprecated": true
    },
    "continueOnFailure": {
      "type": "boolean",
      "title": "Continueonfailure",
      "default": false
    },
    "recordingEnabled": {
      "type": "boolean",
      "title": "Recordingenabled",
      "description": "Record device video for the whole task and persist a retrievable reference",
      "default": false
    },
    "deviceId": {
      "type": "string",
      "format": "uuid",
      "title": "Deviceid",
      "description": "The ID of the device to run the task on."
    },
    "displayId": {
      "type": "integer",
      "title": "Displayid",
      "description": "The display ID of the device to run the task on.",
      "default": 0
    },
    "systemPrompt": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32000
        },
        {
          "type": "null"
        }
      ],
      "title": "Systemprompt",
      "description": "Optional custom behavioral overlay applied on top of the agent's default system prompts. Never echoed back in responses or errors."
    },
    "humanize": {
      "type": "boolean",
      "title": "Humanize",
      "description": "Request human-like input where supported by the device. Replaces the deprecated stealth field; both must agree when supplied together.",
      "default": false
    },
    "internal": {
      "type": "boolean",
      "title": "Internal",
      "description": "Mark a task started by an agent or worker on the user's behalf. It is listed as source='agent' (excluded from source='api' lists) and its events carry internal=true so user-facing notifications and webhooks skip it. It is still billed, controllable and retrievable by id.",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "task",
    "deviceId"
  ],
  "$defs": {
    "PackageCredentials": {
      "properties": {
        "packageName": {
          "type": "string",
          "title": "Packagename"
        },
        "credentialNames": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Credentialnames"
        }
      },
      "type": "object",
      "required": [
        "packageName",
        "credentialNames"
      ],
      "title": "PackageCredentials"
    },
    "VPNCountry": {
      "type": "string",
      "enum": [
        "US",
        "BR",
        "FR",
        "DE",
        "IN",
        "JP",
        "KR",
        "ZA"
      ],
      "title": "VPNCountry"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mobilerun-ai-task-create"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.