{
  "$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"
    }
  }
}