Posts

Update a post

Partial update. Every field is optional, but unrecognised top-level keys are rejected — send the caption nested under content, never as a top-level text.

put/posts/{id}

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/posts/{id}
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (authorization code, authorization URL /api/oauth/authorize, token URL /api/oauth/token, scopes: posts:write)

Path parameters

idstring required

MongoDB ObjectId (24-character hex string)

Example:507f1f77bcf86cd799439011

Request body

platform_overridesobject
schedule_type'immediate' | 'scheduled'
scheduled_atstring date-time
timezonestring
status'draft' | 'scheduled' | 'publishing' | 'published' | 'partially_published' | 'failed' | 'pending_approval'
tagsstring[]
acknowledge_unconfirmedboolean

Set true, after checking X, to re-arm an X Article whose last publish is unconfirmed (it may already be live). Without it such an edit answers 409 with code ARTICLE_UNCONFIRMED.

Example request

{
  "platforms": [
    {
      "account_id": "507f1f77bcf86cd799439011"
    }
  ],
  "tags": [
    "507f1f77bcf86cd799439011"
  ]
}

Response

Post updated

Example response

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "platforms": [
      {
        "account_id": "507f1f77bcf86cd799439011"
      }
    ]
  }
}

Changes

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