OnlySocial
  1. Posts
OnlySocial
  • 🐶 OnlySocial API Walk through
  • Only Social
    • Accounts
      • List Accounts
      • Get an account
    • Media
      • List media files
      • Get a media file
      • Upload a media file
      • Delete a media file
      • Update a Media
    • Tags
      • List Tags
      • Get a tag
      • Create a tag
      • Delete a tag
      • Update a tag
    • Posts
      • List posts
        GET
      • Get a post
        GET
      • Create a post
        POST
      • Delete a post
        DELETE
      • Delete multiple post
        DELETE
      • Schedule a post
        POST
      • Add a post to Queue
        POST
      • Update a post
        PUT
      • Approve a Post
        POST
    • Groups
      • Create a group
      • Update a group
      • Delete a Group
  1. Posts

Update a post

PUT
https://app.onlysocial.io/os/api/{workspaceUuid}/posts/{postUuid}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Body Params application/json

Example
{
    "accounts": [account_id],
    "versions": [{
        "account_id": 0,
        "is_original": true,
        "content": [{
            "body": "",
            "media": [media_ids],
            "url": ""
        }],
        "options": {
            "instagram": {
                "type": "reel",
                "collaborators": [usernames]
            },
            "instagram_direct": {
                "type": "reel",
                "collaborators": [usernames]
            },
            "mastodon": {
                "sensitive": false
            },
            "blue_sky": {
                "tags": []
            },
            "facebook_page": {
                "type": "post"
            },
            "threads": {
                "is_carousel": false
            },
            "youtube": {
                "title": "",
                "status": "public"
            },
            "google_m_b": {
                "image_post_type": 0,
                "video_post_type": 0,
                "text_post_type": 0,
                "all_post_type": 1,
                "topic_type": "none",
                "event_title": null,
                "start_date": null,
                "start_time": null,
                "end_date": null,
                "end_time": null,
                "selected_button_type": "NONE",
                "redirect_url": null,
                "couponCode": null,
                "redeemOnlineUrl": null,
                "termsConditions": null,
                "selected_media_category": "CATEGORY_UNSPECIFIED",
                "gmb_post": null
            },
            "reddit": {
                "title": null,
                "link": null,
                "subreddits": [],
                "flairs_status": null,
                "post_to_profile": true
            },
            "pinterest": {
                "title": "",
                "link": "",
                "boards": {
                    "account-0": null
                }
            },
            "linkedin": {
                "visibility": "PUBLIC",
                "document": null,
                "document_title": null
            },
            "linkedin_page": {
                "visibility": "PUBLIC",
                "document": null,
                "document_title": null
            },
            "tiktok": {
                "privacy_level": {
                    "account-0": ""
                },
                "allow_comments": {
                    "account-0": false
                },
                "allow_duet": {
                    "account-0": false
                },
                "allow_stitch": {
                    "account-0": false
                },
                "content_disclosure": {
                    "account-0": false
                },
                "brand_organic_toggle": {
                    "account-0": false
                },
                "brand_content_toggle": {
                    "account-0": false
                }
            },
            "tumblr": {
                "tumblr_image_post_type": 0,
                "tumblr_video_post_type": 0,
                "tumblr_text_post_type": 1,
                "tumblr_link_post_type": 0,
                "tumblr_quote_post_type": 0,
                "tumblr_chat_post_type": 0,
                "tumblr_post_type": "text",
                "tumblr_post_title": "",
                "tumblr_post_chat_title": "",
                "tumblr_post_link": "",
                "tumblr_post": null
            }
        }
    }],
    "tags": [],
    "date": null,
    "time": "",
    "until_date": null,
    "until_time": "",
    "repeat_frequency": null,
    "short_link_provider": null,
    "short_link_provider_id": null
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request PUT 'https://app.onlysocial.io/os/api/<workspaceUuid>/posts/{postUuid}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accounts": [account_id],
    "versions": [{
        "account_id": 0,
        "is_original": true,
        "content": [{
            "body": "",
            "media": [media_ids],
            "url": ""
        }],
        "options": {
            "instagram": {
                "type": "reel",
                "collaborators": [usernames]
            },
            "instagram_direct": {
                "type": "reel",
                "collaborators": [usernames]
            },
            "mastodon": {
                "sensitive": false
            },
            "blue_sky": {
                "tags": []
            },
            "facebook_page": {
                "type": "post"
            },
            "threads": {
                "is_carousel": false
            },
            "youtube": {
                "title": "",
                "status": "public"
            },
            "google_m_b": {
                "image_post_type": 0,
                "video_post_type": 0,
                "text_post_type": 0,
                "all_post_type": 1,
                "topic_type": "none",
                "event_title": null,
                "start_date": null,
                "start_time": null,
                "end_date": null,
                "end_time": null,
                "selected_button_type": "NONE",
                "redirect_url": null,
                "couponCode": null,
                "redeemOnlineUrl": null,
                "termsConditions": null,
                "selected_media_category": "CATEGORY_UNSPECIFIED",
                "gmb_post": null
            },
            "reddit": {
                "title": null,
                "link": null,
                "subreddits": [],
                "flairs_status": null,
                "post_to_profile": true
            },
            "pinterest": {
                "title": "",
                "link": "",
                "boards": {
                    "account-0": null
                }
            },
            "linkedin": {
                "visibility": "PUBLIC",
                "document": null,
                "document_title": null
            },
            "linkedin_page": {
                "visibility": "PUBLIC",
                "document": null,
                "document_title": null
            },
            "tiktok": {
                "privacy_level": {
                    "account-0": ""
                },
                "allow_comments": {
                    "account-0": false
                },
                "allow_duet": {
                    "account-0": false
                },
                "allow_stitch": {
                    "account-0": false
                },
                "content_disclosure": {
                    "account-0": false
                },
                "brand_organic_toggle": {
                    "account-0": false
                },
                "brand_content_toggle": {
                    "account-0": false
                }
            },
            "tumblr": {
                "tumblr_image_post_type": 0,
                "tumblr_video_post_type": 0,
                "tumblr_text_post_type": 1,
                "tumblr_link_post_type": 0,
                "tumblr_quote_post_type": 0,
                "tumblr_chat_post_type": 0,
                "tumblr_post_type": "text",
                "tumblr_post_title": "",
                "tumblr_post_chat_title": "",
                "tumblr_post_link": "",
                "tumblr_post": null
            }
        }
    }],
    "tags": [],
    "date": null,
    "time": "",
    "until_date": null,
    "until_time": "",
    "repeat_frequency": null,
    "short_link_provider": null,
    "short_link_provider_id": null
}'

Responses

🟢200Success
application/json
Body

Example
{
  "success": true,
}
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠422Parameter Error
Modified at 2025-07-08 07:54:10
Previous
Add a post to Queue
Next
Approve a Post
Built with