---
title: "Perform a conversation item action"
method: POST
path: "/inbox/{inboxId}/{convoId}/items/{itemId}/{action}"
tags: ["Social Inbox"]
---

# Perform a conversation item action

`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

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

## Path parameters

- `inboxId` string, required
- `convoId` integer, required
- `itemId` integer, required
- `action` string, required

## Request body

- InboxActionRequest: Optional action payload. Supported fields depend on the network and action. Common actions include: - `message`, `reply`, `comment`: send text and/or supported media. - `react`: send a reaction value where the network supports message reactions. - `vote`: send a Reddit-style vote value where voting is supported. Actions such as `like`, `dislike`, `delete`, `hide`, `unhide`, `spam`, `repost`, and `unrepost` usually do not need a body.
  - `content` string: Text for comment/reply/message actions. Some networks also accept `text` or `message`.
  - `text` string: Alternate text field accepted by some network handlers.
  - `message` string: Alternate message field accepted by some network handlers.
  - `attachments` object[]: Media attachments for networks/actions that support media responses.
  - `reaction` string: Reaction value for `react`, such as `love` or an emoji, depending on the network.
  - `vote` -1 | 0 | 1: Vote direction for `vote`, where supported.

## Response `200`

Action performed successfully.

- object

## Other responses

- `400`: Invalid item or action request.
- `404`: Conversation item not found or not available to the authenticated user.
- `422`: The action is not valid for this item.

---

[API](https://skmtc.dev/socialbu/apis/socialbu-api.md) · [All operations](https://skmtc.dev/socialbu/apis/socialbu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialbu/apis/socialbu-api/revisions/841b3ab0f671?raw)