Posts

Update a post

patch/posts/{id}

Path parameters

idstring required

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. A post that is waiting for approval keeps its in_approval status and only its time moves. Send null to unschedule back to draft.

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

google_businessGoogleBusiness — unresolved $ref

linkedinLinkedin — unresolved $ref

linkedin_pageLinkedinPage — unresolved $ref

linkedin_pollLinkedinPoll — unresolved $ref

Response

Post updated

Example response

{
  "data": {
    "app_url": "https://app.omnisocials.com/create-post/1024",
    "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"
    },
    "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."
    },
    "threads": {
      "location": {
        "id": "17841400000000000",
        "name": "Griffith Observatory",
        "city": "Los Angeles",
        "country": "United States"
      }
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.