Posts

Apply one action to existing posts

Schedule, delete or set the status of up to 50 existing posts. schedule needs scheduled_for; update_status needs status. It does not create posts: create each one with POST /posts.

post/posts/bulk

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/posts/bulk
  • 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)

Request body

action'schedule' | 'delete' | 'update_status' required
post_idsstring[] required
scheduled_forstring date-time

ISO 8601. Required for schedule.

timezonestring

IANA zone for schedule. Defaults to UTC.

status'draft' | 'scheduled'

Required for update_status.

Example request

{
  "post_ids": [
    "507f1f77bcf86cd799439011"
  ]
}

Response

Bulk action result

Changes

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