DRdroidrun
Tasks

Run Task

Changed on

Create and dispatch a new agent task. Returns the task ID and device stream details.

post/tasks

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/tasks
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

llmModelstring

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.

taskstring required
maxStepsinteger
temperaturenumber

Deprecated and ignored. Sampling behavior is controlled by the model provider.

reasoningboolean
accessibilityboolean
visionboolean
executionTimeoutinteger

Maximum agent execution time in seconds (1–2700).

appsstring[]
filesstring[]
outputSchemaobject nullable
vpnCountry'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA'
subagentModelstring

LLM model used by sub-agent roles: executor, app_opener, structured_output

stealthboolean

Deprecated: use humanize. Both names must agree when supplied together.

continueOnFailureboolean
recordingEnabledboolean

Record device video for the whole task and persist a retrievable reference

deviceIdstring uuid required

The ID of the device to run the task on.

displayIdinteger

The display ID of the device to run the task on.

systemPromptstring nullable

Optional custom behavioral overlay applied on top of the agent's default system prompts. Never echoed back in responses or errors.

humanizeboolean

Request human-like input where supported by the device. Replaces the deprecated stealth field; both must agree when supplied together.

Response

Successful Response

idstring uuid required

The ID of the task

status'prepared' | 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled' required
streamUrlstring nullable

The URL of the stream (null when queued)

Changes

  • d9f54edb041bRevision changes
    • info

      the request property default value changed from openai/gpt-6-luna to mobilerun/mobile-agent-fast

    • info

      the request property default value changed from openai/gpt-6-luna to mobilerun/mobile-agent-fast

  • 4ad548c528a8Revision changes
    • warning

      the request property's max was set to 2700.00

    • warning

      the request property's min was set to 1.00

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      added the new prepared enum value to the response property for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property default value changed from google/gemini-3.5-flash to openai/gpt-6-luna

    • info

      the request property default value changed from google/gemini-3.5-flash to openai/gpt-6-luna

    • info

      request property deprecated

    • info

      request property deprecated

    • info

      added the non-success response with the status