Skip to main content

​
Endpoint

POST https://api.ugc.inc/post/update

​
Overview

Update an existing post without deleting and recreating it. The post retains its original ID. Only posts with draft, scheduled, or failed status can be updated.
Draft Post Behavior:When updating a draft post with both accountId and postTime, the post will automatically transition to scheduled status. If only one is provided, the draft is updated but remains in draft status.
Failed Post Behavior:When updating a post with failed status, the post will automatically be reset to scheduled status with its failure reason cleared. This allows you to fix issues and reschedule the post.
Post type cannot be changed. A video post remains a video post and a slideshow post remains a slideshow post. To change the post type, delete the post and create a new one.

​
Request Body

​
postId
string
required
The ID of the post to update
​
caption
string
New caption for the post (max 500 characters)
​
title
string
New title for the post (max 90 characters, slideshow posts only)
​
socialAudioId
string
New social audio ID for the post
​
postTime
string
New scheduled time in ISO 8601 format. The time may be adjusted if the requested slot is unavailable.
​
accountId
string
Move the post to a different account. The new account must belong to the same organization.
​
mediaUrls
string[]
Replace the post’s media URLs. For video posts, provide a single URL. For slideshow posts, provide one or more image URLs.
​
excludePostIds
string[]
Array of post IDs to exclude from schedule conflict checks when updating postTime. Useful when batch-updating multiple posts to prevent them from conflicting with each other.

​
Response

​
data
Post
The updated post object

​
Error Cases

  • 404 Not Found: Post doesn’t exist or doesn’t belong to your organization
  • 400 Bad Request: Post ID not provided, caption exceeds 500 characters, title exceeds 90 characters, or post is not in an editable status
  • 400 Bad Request: Cannot update post — only draft, scheduled, or failed posts can be updated
curl -X POST https://api.ugc.inc/post/update \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postId": "post_abc123",
    "caption": "Updated caption!",
    "postTime": "2025-01-15T14:00:00Z"
  }'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "id": "post_abc123",
    "account_id": "acc_xyz789",
    "type": "video",
    "status": "scheduled",
    "caption": "Updated caption!",
    "title": null,
    "media_urls": ["https://blob.vercel-storage.com/video.mp4"],
    "social_audio_id": null,
    "music_post_id": null,
    "scheduled_at": "2025-01-15T14:00:00.000Z"
  }
}