WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

Update a chat

PATCH/api/linkedin/gateway/chats/{chat_id}

Performs one state-changing action on a chat at a time — mark it read, mute it, manage a group's members, or fetch its invite link — rather than a general field-by-field edit.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription
chat_id *stringThe chat to update.

Body parameters

FieldTypeDescription
account_id *stringThe account this chat belongs to. Must belong to this key.
action *"setReadStatus" | "setMuteStatus" | "setArchiveStatus" | "setPinnedStatus" | "addParticipant" | "removeParticipant" | "setLabel" | "getInviteLink"Which single action to perform.
valueboolean | stringRequired for every action except getInviteLink — a boolean for the status toggles, a participant id for addParticipant/removeParticipant, or a label name for setLabel.

Response fields

FieldTypeDescription
invite_linkstringOnly present when action was getInviteLink.
On LinkedIn accounts only setReadStatus and setMuteStatus are available — archiving, pinning, labels, group membership and invite links are for other connected channels.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No chat with that id exists for this account.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl -X PATCH https://api.warmably.com/api/linkedin/gateway/chats/9c5e2a71-4b3f-4e8a-9c2d-9f1e6a2b7c44 \
  -H "Authorization: Bearer wm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
    "action": "setReadStatus",
    "value": true
  }'
Response
200 OK
{
  "object": "ChatPatched"
}
No key yet? Create one from Dashboard → API Keys.