Posts
patch/posts/{id}

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/posts/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:1024

Request body

contentobject
accountsstring[]
type'post' | 'story' | 'reel'

Change post type (draft only)

mediaMedia (unresolved $ref)
media_idsMedia (unresolved $ref)
media_urlsMediaUrls (unresolved $ref)
schedule_atstring date-time

New publish time (ISO 8601, must be in the future). A draft becomes scheduled (or stays a planned draft when draft: true is sent with it). A post that is waiting for approval keeps its in_approval status and only its time moves. Send null to unschedule back to a draft without a date; a post that was waiting for approval then leaves its approval workflow (approval_status becomes none).

draftboolean

Planned-draft switch. false without schedule_at schedules a draft at the schedule_at it already carries (400 validation_error when it has none or it is in the past). true without schedule_at unschedules a scheduled post: it keeps its time and stays on the calendar as a dashed draft, nothing publishes; a post waiting for approval leaves its workflow. true with schedule_at moves the time and keeps (or makes) the post a draft.

media_fitMediaFit (unresolved $ref)
location_idLocationId (unresolved $ref)
collaboratorsCollaborators (unresolved $ref)
user_tagsUserTags (unresolved $ref)
pinterestPinterest (unresolved $ref)
youtubeYoutube (unresolved $ref)
instagramInstagram (unresolved $ref)
tiktokTiktok (unresolved $ref)
xX (unresolved $ref)
blueskyBluesky (unresolved $ref)
mastodonMastodon (unresolved $ref)
threadsThreads (unresolved $ref)
telegramTelegram (unresolved $ref)
discordDiscord (unresolved $ref)
google_businessGoogleBusiness (unresolved $ref)
linkedinLinkedin (unresolved $ref)
linkedin_pageLinkedinPage (unresolved $ref)
linkedin_pollLinkedinPoll (unresolved $ref)
comment_dm_automationCommentDmAutomation (unresolved $ref)
tagsTags (unresolved $ref)

Response

Post updated

Example response

{
  "data": {
    "id": "1024",
    "content": {
      "default": "Our autumn menu is here.",
      "instagram": "Our autumn menu is here. #autumnmenu"
    },
    "accounts": {
      "instagram": true,
      "linkedin_page": true,
      "facebook": false,
      "x": false
    },
    "media": {
      "default": [
        {
          "url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-k3j9xq_0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70.jpg",
          "id": "482913",
          "alt": "A bowl of pumpkin soup on a wooden table"
        }
      ]
    },
    "location_id": "1234567890",
    "collaborators": [
      "partnerbrand"
    ],
    "user_tags": [
      {
        "username": "partnerbrand",
        "x": 0.5,
        "y": 0.8
      }
    ],
    "schedule_at": "2026-10-21T09:00:00.000Z",
    "app_url": "https://app.omnisocials.com/create-post/1024",
    "tags": [
      {
        "id": 12,
        "name": "Question hook"
      }
    ],
    "published_urls": {
      "facebook": "https://www.facebook.com/123456789/posts/987654321",
      "instagram": "https://www.instagram.com/p/Cxyz123ABC/",
      "linkedin": "https://www.linkedin.com/feed/update/urn:li:share:7191234567890",
      "x": "https://x.com/yourhandle/status/1791234567890123456"
    },
    "retry_of": "1023",
    "retries": [
      "1031"
    ],
    "created_at": "2026-10-20T14:32:10.000Z",
    "errors": {
      "facebook": "Already Posted: These photos were already posted.",
      "instagram": "Instagram couldn't accept one of your images. Check that every image is JPEG/PNG, at least 320×320, has an aspect ratio between 4:5 and 1.91:1, and isn't visually flagged by Instagram. Re-upload or replace the offending image and try again."
    },
    "source": "api",
    "updated_at": "2026-10-20T14:35:42.000Z",
    "x": {
      "poll": {
        "options": [
          "Yes"
        ]
      },
      "thread_parts": [
        {
          "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
          "text": "1/3: our results are in"
        }
      ]
    },
    "bluesky": {
      "thread_parts": [
        {
          "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
          "text": "1/3: our results are in"
        }
      ]
    },
    "mastodon": {
      "poll": {
        "options": [
          "Yes"
        ]
      },
      "thread_parts": [
        {
          "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
          "text": "1/3: our results are in"
        }
      ]
    },
    "threads": {
      "poll": {
        "options": [
          "Yes"
        ]
      },
      "topic_tag": "Build in public",
      "location": {
        "id": "17841400000000000",
        "name": "Griffith Observatory",
        "address": "2800 E Observatory Rd",
        "city": "Los Angeles",
        "country": "United States"
      },
      "thread_parts": [
        {
          "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
          "text": "1/3: our results are in"
        }
      ]
    },
    "telegram": {
      "link_preview": true,
      "pin": true,
      "buttons": [
        {
          "text": "See the menu",
          "url": "https://example.com/menu"
        }
      ],
      "poll": {
        "options": [
          "Yes"
        ],
        "open_period": 86400
      },
      "result": {
        "chat_id": "-1001234567890",
        "message_ids": [
          "42"
        ],
        "text_message_id": "43",
        "pinned": true,
        "link_public": "https://t.me/brand/42",
        "link_private": "https://t.me/c/1234567890/42",
        "sent_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "discord": {
      "link_preview": true,
      "thread_name": "October menu",
      "buttons": [
        {
          "text": "See the menu",
          "url": "https://example.com/menu"
        }
      ],
      "poll": {
        "options": [
          "Yes"
        ],
        "duration_hours": 24
      },
      "result": {
        "webhook_id": "1290000000000000000",
        "guild_id": "1180000000000000000",
        "channel_id": "1180000000000000001",
        "message_id": "1300000000000000000",
        "url": "https://discord.com/channels/1180000000000000000/1180000000000000001/1300000000000000000",
        "sent_at": "2026-10-22T09:00:03.000Z",
        "warnings": [
          "media_sent_as_links"
        ]
      }
    },
    "instagram": {
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "video_cover": {
      "type": "frame",
      "thumb_offset": 3000,
      "overrides": {
        "linkedin_page": {
          "type": "custom",
          "cover_url": "https://example.com/cover.jpg"
        }
      }
    },
    "facebook": {
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "linkedin": {
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "linkedin_page": {
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "youtube": {
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "tiktok": {
      "title": "Autumn menu",
      "first_comment": "Full menu at the link in our bio.",
      "first_comment_result": {
        "posted_at": "2026-10-21T09:00:07.000Z"
      }
    },
    "comment_dm_automation": {
      "id": "318",
      "name": "Guide DM",
      "post_id": "1024",
      "instagram_media_id": "17912345678901234",
      "facebook_post_id": "104857600123456_987654321098765",
      "trigger": {
        "keywords": [
          "guide"
        ]
      },
      "actions": {
        "dm": {
          "text": "Here is the guide: https://example.com/guide"
        },
        "public_reply": {
          "enabled": true,
          "variations": [
            "Sent you a DM!"
          ]
        }
      },
      "limits": {
        "max_sends": 500,
        "stop_at": "2026-11-30T23:00:00.000Z"
      },
      "stats": {
        "matched": 120,
        "sent": 112,
        "skipped": 6,
        "failed": 2,
        "last_event_at": "2026-10-21T15:00:12.000Z"
      },
      "created_at": "2026-10-20T14:32:10.000Z",
      "updated_at": "2026-10-20T14:35:42.000Z",
      "platforms": [
        "instagram",
        "facebook"
      ],
      "automations": [
        {
          "id": "318"
        }
      ]
    }
  }
}

Changes

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the new optional request property /

    • info

      added the optional property // to the response with the status