Update Post

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"
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/post/update',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'postId': 'post_abc123',
        'caption': 'Updated caption!',
        'postTime': '2025-01-15T14:00:00Z'
    }
)

data = response.json()

if data['ok']:
    post = data['data']
    print(f"Updated post {post['id']} - status: {post['status']}")
else:
    print(f"Error: {data['message']}")

const response = await fetch('https://api.ugc.inc/post/update', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    postId: 'post_abc123',
    caption: 'Updated caption!',
    postTime: '2025-01-15T14:00:00Z'
  })
});

const data = await response.json();

if (data.ok) {
  console.log(`Updated post ${data.data.id}`);
  console.log(`Status: ${data.data.status}`);
} else {
  console.error(`Error: ${data.message}`);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Update caption and schedule time
const response = await client.posts.updatePost({
  postId: 'post_abc123',
  caption: 'Updated caption!',
  postTime: '2025-01-15T14:00:00Z'
});

if (response.ok) {
  console.log(`Updated post ${response.data.id}`);
  console.log(`Status: ${response.data.status}`);
  console.log(`Scheduled at: ${response.data.scheduled_at}`);
} else {
  console.error(`Error: ${response.message}`);
}

// Replace media for a video post
const mediaResponse = await client.posts.updatePost({
  postId: 'post_def456',
  mediaUrls: ['https://example.com/new-video.mp4']
});

// Move post to a different account
const moveResponse = await client.posts.updatePost({
  postId: 'post_ghi789',
  accountId: 'acc_newaccount'
});

{
  "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"
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "id": "post_abc123",
    "account_id": "acc_xyz789",
    "type": "slideshow",
    "status": "scheduled",
    "caption": "Fixed caption",
    "title": "My slideshow",
    "media_urls": ["https://blob.vercel-storage.com/img1.jpg", "https://blob.vercel-storage.com/img2.jpg"],
    "social_audio_id": "audio_123",
    "music_post_id": null,
    "scheduled_at": "2025-01-15T14:00:00.000Z"
  }
}

{
  "ok": false,
  "code": 400,
  "message": "Cannot update post with status \"complete\". Only scheduled or failed posts can be updated."
}

{
  "ok": false,
  "code": 404,
  "message": "Post not found or doesn't belong to your organization"
}

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

string

required

The ID of the post to update

string

New caption for the post (max 4000 characters)

string

New title for the post (max 90 characters, slideshow posts only)

New social audio ID for the post

string

New scheduled time in ISO 8601 format. The time may be adjusted if the requested slot is unavailable.

string

Move the post to a different account. The new account must belong to the same organization.

string[]

Replace the post’s media URLs. For video posts, provide a single URL. For slideshow posts, provide one or more image URLs.

string

Custom tag stored on the post (returned as tag on the Post object). Unlike other fields, an update containing only post_tag is allowed on posts of any status, including complete.

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

Post

The updated post object

Show Post properties

string

Post ID (unchanged from the original post)

string

Account ID the post belongs to

string

Post type: video or slideshow

string

Post status (will be scheduled after update)

string | null

Post caption

string | null

Custom tag stored on the post (from post_tag)

string | null

Post title

string[] | null

Media URLs for the post

Social audio ID

string | null

Music post ID (deprecated)

string | null

Scheduled time in ISO 8601 format

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 4000 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"
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/post/update',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'postId': 'post_abc123',
        'caption': 'Updated caption!',
        'postTime': '2025-01-15T14:00:00Z'
    }
)

data = response.json()

if data['ok']:
    post = data['data']
    print(f"Updated post {post['id']} - status: {post['status']}")
else:
    print(f"Error: {data['message']}")

const response = await fetch('https://api.ugc.inc/post/update', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    postId: 'post_abc123',
    caption: 'Updated caption!',
    postTime: '2025-01-15T14:00:00Z'
  })
});

const data = await response.json();

if (data.ok) {
  console.log(`Updated post ${data.data.id}`);
  console.log(`Status: ${data.data.status}`);
} else {
  console.error(`Error: ${data.message}`);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Update caption and schedule time
const response = await client.posts.updatePost({
  postId: 'post_abc123',
  caption: 'Updated caption!',
  postTime: '2025-01-15T14:00:00Z'
});

if (response.ok) {
  console.log(`Updated post ${response.data.id}`);
  console.log(`Status: ${response.data.status}`);
  console.log(`Scheduled at: ${response.data.scheduled_at}`);
} else {
  console.error(`Error: ${response.message}`);
}

// Replace media for a video post
const mediaResponse = await client.posts.updatePost({
  postId: 'post_def456',
  mediaUrls: ['https://example.com/new-video.mp4']
});

// Move post to a different account
const moveResponse = await client.posts.updatePost({
  postId: 'post_ghi789',
  accountId: 'acc_newaccount'
});

{
  "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"
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "id": "post_abc123",
    "account_id": "acc_xyz789",
    "type": "slideshow",
    "status": "scheduled",
    "caption": "Fixed caption",
    "title": "My slideshow",
    "media_urls": ["https://blob.vercel-storage.com/img1.jpg", "https://blob.vercel-storage.com/img2.jpg"],
    "social_audio_id": "audio_123",
    "music_post_id": null,
    "scheduled_at": "2025-01-15T14:00:00.000Z"
  }
}

{
  "ok": false,
  "code": 400,
  "message": "Cannot update post with status \"complete\". Only scheduled or failed posts can be updated."
}

{
  "ok": false,
  "code": 404,
  "message": "Post not found or doesn't belong to your organization"
}

Getting Started

Data Structures

Posts

Comments

Accounts

Statistics

Tasks

Organization

Media

Billing

Automations

Endpoint

Overview

Request Body

Response

Error Cases

​Endpoint

​Overview

​Request Body

​Response

​Error Cases

Endpoint

Overview

Request Body

Response

Error Cases