All Products
Search

This Product

    Cloud Phone:DescribeAgentTask

    Document Center

    Cloud Phone:DescribeAgentTask

    Last Updated:Jul 13, 2026

    Queries information about Agent Tasks.

    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

    No

    The list of task IDs.

    string

    No

    The task ID.

    t-bp67acfmxazb4p****

    Response elements

    Element

    Type

    Description

    Example

    object

    Schema of Response

    RequestId

    string

    The request ID.

    310A783E-CC46-5452-A8A3-71AE5DB5****
    Code

    string

    The API status code.

    For example, "200" indicates success.
    Message

    string

    The message returned by the API.

    Success.
    Count

    integer

    The number of tasks.

    1
    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-anzzuho371azi44xr
    UserPrompt

    string

    The user instruction in natural language. The Agent performs operations based on this instruction.

    Download DingTalk from App Store
    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 failed.

    TIMEOUT: The task execution timed out.

    COMPLETED
    RunningAt

    string

    The time when the task was created, in ISO 8601 format.

    2026-04-13T17:42:19Z
    Steps

    string

    The number of steps executed.

    30
    TaskResult

    string

    The task result in the desired state. This field is returned only when CurrentStatus is COMPLETED or FAILED.

    Download DingTalk succeeded.
    TaskDuration

    string

    The task duration. This field is returned only when CurrentStatus is FAILED or COMPLETED.

    50
    TaskDigest

    string

    DigestSource

    string

    Reason

    string

    Examples

    Success response

    JSON format

    {
  "RequestId": "310A783E-CC46-5452-A8A3-71AE5DB5****",
  "Code": "For example, \"200\" indicates success.",
  "Message": "Success.",
  "Count": 1,
  "Tasks": [
    {
      "TaskId": "t-imr0fufqd7cle****",
      "InstanceId": "acp-anzzuho371azi44xr",
      "UserPrompt": "Download DingTalk from App Store",
      "CurrentStatus": "COMPLETED",
      "RunningAt": "2026-04-13T17:42:19Z",
      "Steps": "30",
      "TaskResult": "Download DingTalk succeeded.",
      "TaskDuration": "50",
      "TaskDigest": "",
      "DigestSource": "",
      "Reason": ""
    }
  ]
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.