---
title: "修改发布时间"
method: PATCH
path: "/api/v2/channels/publish/tasks/{taskId}/publish-at"
tags: ["渠道管理/内容发布"]
---

# 修改发布时间

`PATCH /api/v2/channels/publish/tasks/{taskId}/publish-at`

## Request

- Base URL: `https://aitoearn.cn`
- URL: `https://aitoearn.cn/api/v2/channels/publish/tasks/{taskId}/publish-at`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/aitoearn/apis/aitoearn-api/docs/api/v2/channels/publish/tasks/:taskId/publish-at/patch.ts> (a function with typed inputs; its response is checked against the schema)

接口说明：修改待发布任务的发布时间。`taskId` 来自创建发布流程接口成功响应中的 `data.tasks[n].id`；`publishAt` 必须填写未来的 ISO 8601 时间，且任务状态必须允许修改。

## Path parameters

- `taskId` string, required

## Request body

- object
  - `publishAt` string, date-time, required: 目标发布时间

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` object
    - `taskId` string
  - `code` integer, required: 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required: 响应消息。
  - `requestId` string: 请求 ID。
  - `timestamp` integer: 错误响应时间戳，Unix 毫秒。

## Changes

- **2026-11-03** `7cc8f21c4c96`: 1 breaking
  - the response property `data/taskId` became optional for the status `200`

[Operation history](https://skmtc.dev/aitoearn/apis/aitoearn-api/changes/api/v2/channels/publish/tasks/:taskId/publish-at/patch.md)

---

[API](https://skmtc.dev/aitoearn/apis/aitoearn-api.md) - [All operations](https://skmtc.dev/aitoearn/apis/aitoearn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aitoearn/apis/aitoearn-api/revisions/7cc8f21c4c96?raw)