Menu

Create Scheduled Task

Usage Instructions

Create Scheduled Task

Request Instructions

  • Method: POST
  • Endpoint: /api/v1/automation/addTask

Request Parameters

Parameter Type Required Description
template_id string Yes Template ID
template_type int Yes Template source (1: Official template, 2: Custom template)
name string Yes Task name
remark string No Task remark
images array Yes Task data

images

Parameter Type Required Description
image_id string Yes Cloud phone ID
issue_at string Yes Release time
config object No Data configuration
config.{variable_name} object Conditionally Required Template variable configuration. The object key is usually the same as the internal key.

config.{variable_name}

Parameter Type Required Description
key string Yes Template variable name, e.g. Search-Content.
value string/array Yes Variable value. When key is file, value must be passed as an array.
type string Yes Parameter type, e.g. file for file, textarea for bulk text, boolean for boolean, number for number, string for string, and excel for Excel upload
required bool Yes Whether required, true means required; false means optional

Request Example

json Copy
{
    "template_id": "xxx",
    "template_type": "2",
    "name": "xxx",
    "remark": "xxxx",
    "images": [
        {
            "image_id": "xxx",
            "config": {
                "file": {                        // Template variable name
                    "key": "file",               // Template variable name
                    "value": [                   // Valid image address or cloud drive file ID (uploaded files can retrieve the ID through the File List)
                        "L1ZVt",                 // File ID
                        "https://xxx/xxx.png"    // Valid image address
                    ],
                    "type": "file",
                    "required": true
                },
                "text": {
                    "key": "text",
                    "value": "123\n456",
                    "type": "textarea",
                    "required": true
                },
                "bool": {
                    "key": "bool",
                    "value": "true",
                    "type": "boolean",
                    "required": true
                },
                "age": {
                    "key": "age",
                    "value": "18",
                    "type": "number",
                    "required": true
                },
                "name": {
                    "key": "name",
                    "value": "duoplus",
                    "type": "string",
                    "required": true
                },
                "email": {
                    "key": "email",
                    "value": "email1,email2",
                    "type": "excel",
                    "required": false
                },
                "password": {
                    "key": "password",
                    "value": "password1,passowrd2",
                    "type": "excel",
                    "required": false
                }
            },
            "issue_at": "2025-12-20 14:01"
        }
    ]
}

Response Example

json Copy
{
    "code": 200,
    "data": {
        "message": "success"
    },
    "message": "success"
}
Previous
Official Template Details
Next
Create Loop Task
Last modified: 2026-09-16Powered by