CLI Commands

chatwoot convs                                 # open conversations assigned to you (default)
chatwoot convs -s resolved                     # by status: open | resolved | pending | snoozed
chatwoot convs --assignee all                  # me (default) | unassigned | all | <name> | <id>
chatwoot convs --inbox 5                       # filter by inbox ID
chatwoot convs -l billing,urgent               # filter by labels
chatwoot convs --query "refund"                # search by message content

chatwoot conv 123                              # view (default)
chatwoot conv 123 messages                     # list messages

chatwoot conv 123 reply "Thanks, looking into it"
chatwoot conv 123 reply "internal note" --private

chatwoot conv 123 resolve
chatwoot conv 123 open
chatwoot conv 123 pending
chatwoot conv 123 snooze                       # snooze until next reply
chatwoot conv 123 snooze --until 24h           # 7d, 2026-05-10, ...

chatwoot conv 123 assign --agent me            # yourself
chatwoot conv 123 assign --agent alice         # case-insensitive substring on name
chatwoot conv 123 assign --agent 42            # by agent ID
chatwoot conv 123 assign --team 7              # assign to a team
chatwoot conv 123 unassign

chatwoot conv 123 label billing,urgent         # sets labels (replaces existing)
chatwoot conv 123 priority urgent              # urgent | high | medium | low | none

chatwoot conv 123 contact                      # view the contact (sender) for this conversation

chatwoot contacts                              # list
chatwoot contacts --search "john"              # name, email, or phone
chatwoot contact 456                           # view
chatwoot contact 456 conversations             # this contact's conversations

chatwoot inboxes                               # list inboxes
chatwoot inbox 5                               # view one
chatwoot agents                                # list agents
chatwoot labels                                # list account-level labels
chatwoot teams                                 # list teams

chatwoot hcs                                   # list help centers
chatwoot hc default user-guide                 # save default help center and locale
chatwoot hc default                            # show current default
chatwoot hc default --clear                    # clear current default
chatwoot hc articles --query "api channel"     # search articles
chatwoot hc articles --category channels       # list/search within a category
chatwoot hc article 1677839703-how-to-create-an-api-channel-inbox
chatwoot hc articles --portal user-guide --locale en

chatwoot me                                    # your profile (alias of auth status)
chatwoot whoami                                # same

chatwoot api /conversations/123                # GET /api/v1/accounts/<id>/conversations/123
chatwoot api -X PATCH /conversations/123 --data '{"status":"open"}'
chatwoot api --exact /api/v1/profile           # non-account-scoped endpoint

chatwoot auth login                            # interactive login (caches user_id)
chatwoot auth logout                           # remove saved credentials
chatwoot auth status                           # current user and instance
chatwoot config path                           # print config file path
chatwoot config view                           # print config and credential source

chatwoot version                               # print the CLI version
chatwoot version --check                       # check GitHub for a newer release
chatwoot --version                             # same as `version`, as a flag