Update Scheduled Task

Description
This API is used to modify a previously created scheduled push task. It supports modifying the scheduled time, push content, and other fields. Only tasks with "pending" status can be modified. Tasks that are currently dispatching or have already been dispatched cannot be modified.
API Call Description
Sample Request URL
https://xxxxxx/v4/timpush/modify_sched_task?usersig=xxx&identifier=admin&sdkappid=88888888&random=99999999&contenttype=json
Request parameters
Parameter
Description
https
The request protocol is: HTTPS.
Request method: POST.
xxxxxx
The dedicated domain corresponding to the country/region of your SDKAppID.
China: console.tim.qq.com
Singapore :adminapisgp.im.qcloud.com
Seoul : adminapikr.im.qcloud.com
Frankfurt :adminapiger.im.qcloud.com
Silicon Valley :adminapiusa.im.qcloud.com
Jakarta: adminapiidn.im.qcloud.com
v4/timpush/modify_sched_task
Request API.
usersig
The Signature generated by the App admin account. For details, see Generating UserSig.
identifier
You must be an App admin account. For more details, see App Admins.
sdkappid
SdkAppid assigned by the Instant Messaging Console when an application is created.
random
A random 32-bit unsigned integer ranging from 0 to 4294967295.
contenttype
Fixed value: json.
Call frequency limit
5 requests per second.
Sample Request Body
Modify scheduled time
{
    "Sdkappid": 88888888,
    "TaskID": 1234567890, // TaskID returned when the task was created
    "Type": "All",
    "SchedAt": "2025-06-15 14:00:00"
}
Modify push content
{
    "Sdkappid": 88888888,
    "TaskID": 1234567890,
    "Type": "All",
    "Content": {
        "OfflinePushInfo": {
            "Title": "New Push Title",
            "Desc": "New Push Content Description"
        }
    }
}
Modify multiple fields simultaneously
{
    "Sdkappid": 88888888,
    "TaskID": 1234567890,
    "Type": "All",
    "SchedAt": "2025-07-01 09:00:00",
    "Content": {
        "OfflinePushInfo": {
            "Title": "Updated Title",
            "Desc": "Updated Description"
        }
    }
}
Request Body Field Description
Field
Type
Required
Description
Sdkappid
Integer
Yes
The SDKAppID of the application. Must match the sdkappid in the URL.
TaskID
Integer
Yes
The scheduled task ID returned when the task was created.
Type
String
Yes
Push task type: `All` for push to all users, `Tag` for tag-based push, `User` for single-user push. Type must be the same as when the task was created; changing the task type is not supported.
SchedAt
String
No
Scheduled time in the format `YYYY-MM-DD HH:MM:SS` (UTC time). If not provided, the scheduled time will not be modified.
Content
Object
No
Push task content. If not provided, the content will not be modified. If provided, the structure must match the content format corresponding to the Type specified at creation.
Note:
At least one of SchedAt or Content must be provided. If Content is provided, the system will re-validate the content and re-extract the Title and Desc.
Sample Response Body
Successful modification
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0,
    "TaskID": 1234567890
}
Failed modification
{
    "ActionStatus": "FAIL",
    "ErrorInfo": "modify failed: task dispatching",
    "ErrorCode": 90107,
    "TaskID": 0
}
Response Body Field Description
Field
Type
Description
ActionStatus
String
The result of the request. OK indicates success, FAIL indicates failure.
ErrorCode
Integer
Error code. 0 indicates success, non-0 indicates failure.
ErrorInfo
String
Error message.
TaskID
Integer
The ID of the modified scheduled task.
Error Codes
Unless a network error occurs (e.g. 502 error), the HTTP return code of this API is always 200. The actual error code and error message are indicated by ErrorCode and ErrorInfo in the response body. For common error codes (60000 to 79999), see the Error Codes documentation.
The private error codes for this API are as follows:
Error Code
Description
90104
Invalid request parameters, such as invalid TaskID, illegal Type, incorrect SchedAt format, sdkappid mismatch, task type and content mismatch, etc.
90105
Internal error.
90106
Task has already been dispatched and cannot be modified.
90107
Task is currently dispatching and cannot be modified.
90110
Invalid scheduled time (e.g. the scheduled time has already passed).
﻿

Parameter	Description
https	The request protocol is: HTTPS. Request method: POST.
xxxxxx	The dedicated domain corresponding to the country/region of your SDKAppID. China: `console.tim.qq.com` Singapore :`adminapisgp.im.qcloud.com` Seoul : `adminapikr.im.qcloud.com` Frankfurt :`adminapiger.im.qcloud.com` Silicon Valley :`adminapiusa.im.qcloud.com` Jakarta: `adminapiidn.im.qcloud.com`
v4/timpush/modify_sched_task	Request API.
usersig	The Signature generated by the App admin account. For details, see Generating UserSig.
identifier	You must be an App admin account. For more details, see App Admins.
sdkappid	SdkAppid assigned by the Instant Messaging Console when an application is created.
random	A random 32-bit unsigned integer ranging from 0 to 4294967295.
contenttype	Fixed value: `json`.

Field	Type	Required	Description
Sdkappid	Integer	Yes	The SDKAppID of the application. Must match the sdkappid in the URL.
TaskID	Integer	Yes	The scheduled task ID returned when the task was created.
Type	String	Yes	Push task type: `All` for push to all users, `Tag` for tag-based push, `User` for single-user push. Type must be the same as when the task was created; changing the task type is not supported.
SchedAt	String	No	Scheduled time in the format `YYYY-MM-DD HH:MM:SS` (UTC time). If not provided, the scheduled time will not be modified.
Content	Object	No	Push task content. If not provided, the content will not be modified. If provided, the structure must match the content format corresponding to the Type specified at creation.

Error Code	Description
90104	Invalid request parameters, such as invalid TaskID, illegal Type, incorrect SchedAt format, sdkappid mismatch, task type and content mismatch, etc.
90105	Internal error.
90106	Task has already been dispatched and cannot be modified.
90107	Task is currently dispatching and cannot be modified.
90110	Invalid scheduled time (e.g. the scheduled time has already passed).