Posts
Update a post
Changed onpatch/posts/{id}
Request
- Base URLhttps://api.omnisocials.com/v1
- URLhttps://api.omnisocials.com/v1/posts/{id}
- AuthHTTP bearer
Path parameters
idstring required
Example:1024
Request body
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
- info
added the new optional request property
/ - info
added the optional property
//to the response with the status
- info