WIwithallo
Conversations

Execute conversation action

Execute an action on a conversation.

put/v2/api/conversations/{contact_number}/action

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/conversations/{contact_number}/action
  • Auth
    API key in header Authorization

Path parameters

contact_numberstring required
Example:+14155551234

The external phone number in E.164 format. URL-encode the + as %2B.

Request body

action'READ' | 'UNREAD' | 'ARCHIVE' | 'UNARCHIVE' required

The action to execute.

allo_numberstring

Scope the action to a specific Allo number (E.164). Without this, the action applies across all lines.

Example request

{
  "allo_number": "+14155550100"
}

Response

Action executed successfully

Changes

No recorded changes to this operation across all 2 revisions of this API.