Delete (recall) a message
Recall a message you sent. The message is first recalled on LinkedIn (source of truth); only on success is it soft-deleted locally so a later sync never re-surfaces the recalled tombstone. Other connected clients/tabs are notified via WebSocket. Matching is by the prefix-independent normalized message id, so the stored row is removed even if it was synced under a different mailbox prefix.
/conversations/{conversationUrn}/messages/{messageUrn}Code Examples
curl -X DELETE 'https://api.connectsafely.ai/linkedin/conversations/<conversationUrn>/messages/<messageUrn>' \ -H 'Authorization: Bearer <your_api_key>'Recall a message you sent. The message is first recalled on LinkedIn (source of truth); only on success is it soft-deleted locally so a later sync never re-surfaces the recalled tombstone. Other connected clients/tabs are notified via WebSocket. Matching is by the prefix-independent normalized message id, so the stored row is removed even if it was synced under a different mailbox prefix.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
conversationUrn | path | Yes | string | Conversation URN (URL-encoded) |
messageUrn | path | Yes | string | URN of the message to delete (URL-encoded) |
accountId | query | No | string | LinkedIn account ID |
Request Body
No request body.
Responses
| Status | Description |
|---|---|
| 200 | Message deleted |
| 400 | Recall failed on LinkedIn |
| 401 | Unauthorized |
| 404 | Account not found |
| 500 | Server error |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
messageUrn | string |
200 Example
{
"success": true,
"messageUrn": "Hello! I would like to connect with you."
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
400 Example
{
"error": "example_value"
}401 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
401 Example
{
"error": "example_value"
}404 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
404 Example
{
"error": "example_value"
}500 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string |
500 Example
{
"error": "example_value"
}Get conversation messages
Retrieve messages for a specific conversation. Auto-detects Sales Navigator thread URNs (urn:li:salesNav_thread:*) and routes to the Sales Nav API. Standard conversations use DB-first with LinkedIn API fallback for older messages via cursor pagination. Replaces GET /messaging/conversation-details.
React or unreact to a message
Add or remove an emoji reaction on a message. The reaction is applied on LinkedIn first; other connected clients/tabs are notified via WebSocket. Set react=true to add the reaction, react=false to remove it.