All Products
Search
Document Center

Cloud Phone:ResumeAgentTask

Last Updated:Jul 13, 2026

Resumes an automated Agent task that is running on a Mobile node.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

TaskIds

array

Yes

The list of task IDs.

string

Yes

The task ID.

t-bp67acfmxazb4p****

AdditionalPrompt

string

No

The additional prompt to append. This parameter takes effect only when the task is passively paused, such as when the task is paused and waiting for user confirmation.

验证码为***。

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

1A923337-44D9-5CAD-9A53-95084BD4****

Code

string

The API status code.

200

Message

string

The response message.

Success.

Tasks

array<object>

The list of tasks.

object

The task.

TaskId

string

The task ID, which is globally unique.

t-imr0fufqd7cle****

InstanceId

string

The Mobile node ID.

acp-ek65k51zoxia3x8xz

CurrentStatus

string

The current status of the task. Valid values:

  • PENDING: The task is being created.

  • RUNNING: The task is running.

  • COMPLETED: The task is completed.

  • FAILED: The task has failed.

  • TIMEOUT: The task has timed out.

  • PAUSING: The task is being paused.

  • PAUSED: The task is paused.

RUNNING

ResumingAt

string

The time when the task is resumed, in ISO 8601 format.

2026-04-13T17:42:19Z

FailedReason

string

The reason why the task failed to resume.

Task status [COMPLETED] does not support resume, only PAUSED tasks can be resumed.

Examples

Success response

JSON format

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "Code": "200",
  "Message": "Success.",
  "Tasks": [
    {
      "TaskId": "t-imr0fufqd7cle****",
      "InstanceId": "acp-ek65k51zoxia3x8xz",
      "CurrentStatus": "RUNNING",
      "ResumingAt": "2026-04-13T17:42:19Z",
      "FailedReason": "Task status [COMPLETED] does not support resume, only PAUSED tasks can be resumed."
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.