# st.manageConversation

This action allows you to manage a conversation thread, such as archiving, starring, or muting it.

This action allows you to manage a conversation thread — archive, star, or mute it — by its `threadId`.

## Constraints

> ⏺️ **Root Start:** allowed, when `threadId` parameter is provided.

> ⬆️ **Parent Actions:** [st.sendMessage](/docs/action-st-send-message).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "actionType": "st.manageConversation",
  "label": "thread1",
  "threadId": "2-Zjhm...",
  "operation": "archive"
}
```

- `label` (optional) – custom label for tracking this action in workflow completion.
- `threadId` (required for root start, forbidden for child start) – identifier of the conversation thread to manage, as returned by [inbox polling](/docs/monitoring-inbox) or [conversation polling](/docs/working-with-conversations). You can also read it from the address bar of an open conversation — it is the `<id>` in `linkedin.com/messaging/thread/<id>`. When run as a child of [st.sendMessage](/docs/action-st-send-message), the thread is inherited from the parent send and this parameter must be omitted.
- `operation` – operation to apply to the thread. One of:
  - `archive` / `unarchive` – archive or unarchive the conversation.
  - `star` / `unstar` – star or unstar the conversation.
  - `mute` / `unmute` – mute or unmute the conversation.

## Result options

1. **Successful operation:**

```json
{
  "actionType": "st.manageConversation",
  "label": "thread1",
  "success": true
}
```

- `label` – included only if specified in the action parameters.

2. **Failed operation:**

```json
{
  "actionType": "st.manageConversation",
  "label": "thread1",
  "success": false,
  "error": {
    "type": "threadNotFound",
    "message": "The provided thread identifier does not match an existing conversation."
  }
}
```

- `label` – included only if specified in the action parameters.
- `error.type` – enum with the following possible values:
  - `threadNotFound` – provided `threadId` does not match an existing conversation.