Social Inbox

Perform a conversation item action

Performs a network-supported action on a conversation item. Supported actions and payload fields depend on the item network and type.

post/inbox/{inboxId}/{convoId}/items/{itemId}/{action}

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/inbox/{inboxId}/{convoId}/items/{itemId}/{action}
  • Auth: HTTP bearer

Path parameters

inboxIdstring required

Inbox identifier, such as a_123 or t_45.

convoIdinteger required

Conversation ID.

itemIdinteger required

Conversation item ID.

actionstring required

Network action to perform. Common examples include reply, comment, vote, and react.

Request body

contentstring

Text for comment/reply/message actions. Some networks also accept text or message.

textstring

Alternate text field accepted by some network handlers.

messagestring

Alternate message field accepted by some network handlers.

attachmentsobject[]

Media attachments for networks/actions that support media responses.

reactionstring

Reaction value for react, such as love or an emoji, depending on the network.

vote-1 | 0 | 1

Vote direction for vote, where supported.

Example request

{
  "content": "Thanks for reaching out."
}

Response

Action performed successfully.

object required

Changes

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