Accounts

Disconnect a social account

Disconnects a connected social account owned by the caller. This is irreversible: posterly removes the account row, cleans up local profile-picture storage, preserves reconnect metadata for scheduled posts, archives Instagram analytics, and emits account.disconnected webhooks.

delete/api/v1/accounts/{id}

Request

  • Base URL: https://www.poster.ly
  • URL: https://www.poster.ly/api/v1/accounts/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Connected social account ID

Response

Account disconnected successfully

disconnectedboolean required
stamped_post_countinteger required
transferred_to_account_idinteger nullable required
transferred_post_countinteger required

Example response

{
  "disconnected": true,
  "account": {
    "id": "123",
    "platform": "instagram",
    "username": "thebrightlabuae",
    "account_type": "profile",
    "workspace_id": "2d0a6d4c-9eef-4ee2-9026-2ca0dc29c8d6"
  },
  "stamped_post_count": 4,
  "transferred_to_account_id": null,
  "transferred_post_count": 0,
  "archived_analytics": {
    "snapshots": 30,
    "syncStatus": true
  },
  "restored_analytics": null
}

Changes

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