Delete Posts

curl -X POST https://api.ugc.inc/post/delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postIds": ["post_abc123", "post_def456"]
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/post/delete',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'postIds': ['post_abc123', 'post_def456']
    }
)

data = response.json()

if data['ok']:
    print(f"Deleted {data['data']['deleted']} posts")
else:
    print(f"Error: {data['message']}")

const response = await fetch('https://api.ugc.inc/post/delete', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    postIds: ['post_abc123', 'post_def456']
  })
});

const data = await response.json();

if (data.ok) {
  console.log(`Immediately deleted ${data.data.deleted} posts`);
  console.log(`Queued for deletion: ${data.data.deleting} posts`);
  if (data.data.errors && data.data.errors.length > 0) {
    console.log(`Failed: ${data.data.errors.length} posts`);
  }
} else {
  console.error(`Error: ${data.message}`);
}

import { UGCClient } from 'ugcinc';

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

// Delete multiple posts
const response = await client.posts.deletePosts({
  postIds: ['post_abc123', 'post_def456']
});

if (response.ok) {
  console.log(`Immediately deleted: ${response.data.deleted} posts`);
  console.log('Deleted IDs:', response.data.deletedIds);
  
  if (response.data.deleting > 0) {
    console.log(`Queued for deletion: ${response.data.deleting} published posts`);
    console.log('Deleting IDs:', response.data.deletingIds);
    console.log('These posts will be removed from the platform shortly.');
  }
  
  if (response.data.errors && response.data.errors.length > 0) {
    console.error('Some posts failed to delete:', response.data.errors);
  }
} else {
  console.error(`Error: ${response.message}`);
  // Common errors:
  // - "Some posts not found or don't belong to your organization"
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 2,
    "deleting": 0,
    "deletedIds": [
      "post_abc123",
      "post_def456"
    ],
    "deletingIds": []
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 0,
    "deleting": 2,
    "deletedIds": [],
    "deletingIds": [
      "post_xyz789",
      "post_uvw012"
    ]
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 1,
    "deleting": 1,
    "deletedIds": ["post_abc123"],
    "deletingIds": ["post_xyz789"],
    "errors": [
      {
        "postId": "post_bad999",
        "error": "Account has no GeeLark phone ID"
      }
    ]
  }
}

{
  "ok": false,
  "code": 404,
  "message": "Some posts not found or don't belong to your organization"
}

{
  "ok": false,
  "code": 400,
  "message": "No post IDs provided"
}

Endpoint

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

Overview

Delete one or more posts from your organization. This endpoint handles both scheduled posts and published posts:

Unpublished posts (scheduled, pending, failed, retrying) are deleted immediately from the database
Published posts (complete) trigger a deletion flow that removes the post from the social media platform (TikTok/Instagram) and then marks it as deleted

Published Post Deletion:When deleting a complete post, the API will:

Trigger a GeeLark automation to delete the post from the social media platform
Set the post status to deleting while the deletion is in progress
Automatically update to deleted once the platform deletion completes

You can check the status using the Get Post Status endpoint.

Request Body

string[]

required

Array of post IDs to deleteAll posts must belong to your organization. Posts can be in any status.

Response

object

Deletion result information

Show Result properties

number

Number of posts deleted immediately (unpublished posts)

string[]

Array of post IDs that were deleted immediately

number

Number of published posts queued for deletion from the platform

string[]

Array of post IDs that are being deleted from the platform (status changed to deleting)

array

Array of errors for posts that failed to delete

Show Error object

string

ID of the post that failed

string

Error message

Error Cases

404 Not Found: Some posts don’t exist or don’t belong to your organization
400 Bad Request: No post IDs provided
Partial errors: Some posts may fail to delete while others succeed (returned in errors array)

curl -X POST https://api.ugc.inc/post/delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postIds": ["post_abc123", "post_def456"]
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/post/delete',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'postIds': ['post_abc123', 'post_def456']
    }
)

data = response.json()

if data['ok']:
    print(f"Deleted {data['data']['deleted']} posts")
else:
    print(f"Error: {data['message']}")

const response = await fetch('https://api.ugc.inc/post/delete', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    postIds: ['post_abc123', 'post_def456']
  })
});

const data = await response.json();

if (data.ok) {
  console.log(`Immediately deleted ${data.data.deleted} posts`);
  console.log(`Queued for deletion: ${data.data.deleting} posts`);
  if (data.data.errors && data.data.errors.length > 0) {
    console.log(`Failed: ${data.data.errors.length} posts`);
  }
} else {
  console.error(`Error: ${data.message}`);
}

import { UGCClient } from 'ugcinc';

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

// Delete multiple posts
const response = await client.posts.deletePosts({
  postIds: ['post_abc123', 'post_def456']
});

if (response.ok) {
  console.log(`Immediately deleted: ${response.data.deleted} posts`);
  console.log('Deleted IDs:', response.data.deletedIds);
  
  if (response.data.deleting > 0) {
    console.log(`Queued for deletion: ${response.data.deleting} published posts`);
    console.log('Deleting IDs:', response.data.deletingIds);
    console.log('These posts will be removed from the platform shortly.');
  }
  
  if (response.data.errors && response.data.errors.length > 0) {
    console.error('Some posts failed to delete:', response.data.errors);
  }
} else {
  console.error(`Error: ${response.message}`);
  // Common errors:
  // - "Some posts not found or don't belong to your organization"
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 2,
    "deleting": 0,
    "deletedIds": [
      "post_abc123",
      "post_def456"
    ],
    "deletingIds": []
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 0,
    "deleting": 2,
    "deletedIds": [],
    "deletingIds": [
      "post_xyz789",
      "post_uvw012"
    ]
  }
}

{
  "ok": true,
  "code": 200,
  "message": "Successfully processed deletion request",
  "data": {
    "deleted": 1,
    "deleting": 1,
    "deletedIds": ["post_abc123"],
    "deletingIds": ["post_xyz789"],
    "errors": [
      {
        "postId": "post_bad999",
        "error": "Account has no GeeLark phone ID"
      }
    ]
  }
}

{
  "ok": false,
  "code": 404,
  "message": "Some posts not found or don't belong to your organization"
}

{
  "ok": false,
  "code": 400,
  "message": "No post IDs provided"
}

Best Practices

Deleting published posts:When you delete a post that has already been published (complete status), the API triggers an automation to remove it from the social media platform. The post status changes to deleting and then to deleted once the platform deletion completes. Use the Get Post Status endpoint to monitor the deletion progress.

Delete posts

Call the delete endpoint with the post IDs you want to remove

Check response

The response tells you which posts were deleted immediately vs. queued for platform deletion

Monitor status (for published posts)

For posts being deleted from the platform, monitor their status until it changes to deleted

Example: Bulk Delete with Status Monitoring

// Delete multiple posts (mix of published and unpublished)
const deleteResponse = await client.posts.deletePosts({
  postIds: ['post_abc123', 'post_xyz789', 'post_uvw012']
});

if (deleteResponse.ok) {
  // Handle immediately deleted posts
  if (deleteResponse.data.deleted > 0) {
    console.log(`✓ Deleted ${deleteResponse.data.deleted} unpublished posts`);
  }
  
  // Monitor posts being deleted from platform
  if (deleteResponse.data.deleting > 0) {
    console.log(`⏳ Deleting ${deleteResponse.data.deleting} published posts from platform...`);
    
    // Poll status until deletion completes
    for (const postId of deleteResponse.data.deletingIds) {
      const checkStatus = async () => {
        const statusResponse = await client.posts.getStatus({ postId });
        
        if (statusResponse.ok) {
          if (statusResponse.data.status === 'deleted') {
            console.log(`✓ Post ${postId} deleted from platform`);
            return true;
          } else if (statusResponse.data.status === 'failed') {
            console.error(`✗ Post ${postId} deletion failed`);
            return true;
          }
        }
        return false;
      };
      
      // Check every 10 seconds until complete
      const interval = setInterval(async () => {
        const done = await checkStatus();
        if (done) clearInterval(interval);
      }, 10000);
    }
  }
  
  // Handle any errors
  if (deleteResponse.data.errors && deleteResponse.data.errors.length > 0) {
    console.error('Some posts failed to delete:', deleteResponse.data.errors);
  }
}

Getting Started

Data Structures

Posts

Comments

Accounts

Statistics

Tasks

Organization

Media

Billing

Automations

Endpoint

Overview

Request Body

Response

Error Cases

Best Practices

Example: Bulk Delete with Status Monitoring

​Endpoint

​Overview

​Request Body

​Response

​Error Cases

​Best Practices

​Example: Bulk Delete with Status Monitoring

Endpoint

Overview

Request Body

Response

Error Cases

Best Practices

Example: Bulk Delete with Status Monitoring