Lalexi
APIReferenceConnecting numbers

The number's chats

The chats of the connected account, newest first, to pick a chat filter from. The list is fetched in the background: while status is loading, ask again in a second or two; reload=true fetches it afresh. Bots have no chat list (422 not_supported).

GET
/channels/{channel_id}/chats

Authorization

personalToken
AuthorizationBearer <token>

Your personal access token from Profile → Access Token in Lalexi. It acts with exactly your role: what you may see and do in the workspace, and nothing more. Everything done with it is recorded as done by you.

In: header

Path Parameters

channel_id*integer

The channel's id.

Query Parameters

reload?boolean
Defaultfalse

Header Parameters

X-Workspace-Id?integer

The workspace to work in (an id from GET /me). Optional when you belong to a single workspace; required otherwise (400 workspace_required).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.lalexi.com/v1/channels/0/chats" \  -H "X-Workspace-Id: 7"
{
  "status": "loading",
  "data": [
    {
      "id": "string",
      "name": "string",
      "phone": "string",
      "last_activity_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": {
    "code": "workspace_required",
    "message": "You belong to several workspaces: pass the X-Workspace-Id header."
  }
}
{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is missing or invalid."
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "You are not allowed to do this."
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Resource not found."
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "The request is invalid.",
    "details": {
      "email": [
        "is invalid"
      ]
    }
  }
}
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the number of seconds in Retry-After."
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}
{
  "error": {
    "code": "upstream_unavailable",
    "message": "The messaging service is unavailable. Nothing was sent; try again."
  }
}