nv.manageConversation

This action allows you to manage a conversation thread in Sales Navigator — archive or unarchive it — by its threadId.

Constraints

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

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

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

const workflow = await linkedapi.nvManageConversation.execute({
  threadId: "2-Zjhm...",
  operation: "archive"
});

const { errors } = await linkedapi.nvManageConversation.result(workflow.workflowId);

from linkedapi import NvManageConversationParams

workflow = linkedapi.nv_manage_conversation.execute(
    NvManageConversationParams(
        thread_id="2-Zjhm...",
        operation="archive",
    )
)

result = linkedapi.nv_manage_conversation.result(workflow.workflow_id)

In AI assistants, the MCP server runs this action as the nv_manage_conversation tool.

In the CLI this is linkedin navigator message manage:

bash

linkedin navigator message manage <thread-id> <operation>

Arg	Required	Description
`thread-id`	yes	Conversation thread identifier, as returned by `inbox get --type nv` / `navigator message get`, or the `<id>` in `linkedin.com/sales/inbox/<id>` of an open conversation
`operation`	yes	One of `archive`, `unarchive`

label (optional) – custom label for tracking this action in workflow completion.
threadId (required) – identifier of the conversation thread to manage, as returned by inbox polling. You can also read it from the address bar of an open conversation — it is the <id> in linkedin.com/sales/inbox/<id>.
operation – operation to apply to the thread. One of:
- archive / unarchive – archive or unarchive the conversation.

Result options

Successful operation:

json

{
  "actionType": "nv.manageConversation",
  "label": "thread1",
  "success": true
}

label – included only if specified in the action parameters.

Failed operation:

json

{
  "actionType": "nv.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:
- noSalesNavigator – your account does not have Sales Navigator subscription.
- threadNotFound – provided threadId does not match an existing conversation.

Previousnv.syncInbox Nextnv.searchPeople