Skip to main content
PUT
Cập nhật bài đăng

Yêu cầu

string
bắt buộc
ID của bài đăng.
string
bắt buộc
Trạng thái bài đăng, gồm một trong các giá trị:
  • draft — giữ ở dạng bản nháp
  • scheduled — lên lịch theo thời điểm trong scheduled_at (phải ở tương lai)
  • publishing — đăng ngay: gửi tác vụ đăng tới mọi nền tảng đang bật
Khi dùng scheduled, scheduled_at bắt buộc phải là thời điểm trong tương lai.
string
Phần chú thích hoặc nội dung văn bản của bài đăng.
array
Nội dung đa phương tiện cần gắn với bài đăng. Thông thường, bạn nên tải lên trước qua POST /posts/{post}/media (tệp) hoặc POST /posts/{post} /media/from-url (URL), để các endpoint này tự thêm vào media[].
array
Mảng các nền tảng cần bật. Mọi nền tảng KHÔNG có trong mảng sẽ bị tắt. Truyền mảng rỗng để tắt tất cả.
string
Thời điểm theo ISO 8601. Bắt buộc khi status=scheduled.
array
Mảng UUID của các nhãn cần gắn vào bài đăng. Mảng này thay thế toàn bộ nhãn hiện có.

Phản hồi

Trả về bài đăng đã cập nhật. Nếu bài đã được đăng, API trả về 422 cùng { "message": "Cannot edit a published post." }.

Mẹo

  • Để đăng một bản nháp hiện có, chỉ cần gửi { "status": "publishing" }; nội dung và nền tảng đã lưu vẫn được giữ nguyên.
  • Để lên lịch, gửi { "status": "scheduled", "scheduled_at": "2025-12-31T15:30:00Z" }.
  • Để thay đổi các nền tảng đang hoạt động mà không sửa nội dung, chỉ cần gửi mảng platforms[].