How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Chatwoot

Chatwoot Conversations API

Conversation management APIs

Documentation Provider Profile APIs.io OpenAPI GitHub

Chatwoot Conversations API is one of 40 APIs that Chatwoot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Conversations. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 14 operations across 11 paths, and defines 14 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://app.chatwoot.com/, https://app.chatwoot.com.

14 operations 11 paths 14 schemas 5 GET1 PATCH8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://app.chatwoot.com
Authentication
API Key, API Key, API Key
Terms of Service
View terms
Resource Areas
1

Authentication & Security 3

Chatwoot Conversations API declares 3 security schemes for authenticating requests. An API key is passed in the header as api_access_token (userApiKey). An API key is passed in the header as api_access_token (agentBotApiKey). An API key is passed in the header as api_access_token (platformAppApiKey).

  • userApiKey — This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can…
  • agentBotApiKey — This token should be provided by system admin or obtained via rails console. This token can be used to build bot integrations and can only access limited apis.
  • platformAppApiKey — This token can be obtained by the system admin after creating a platformApp. This token should be used to provision agent bots, accounts, users and their roles.

Paths & Operations 14

Across 11 paths, the API surfaces 14 operations — 5 GET, 1 PATCH, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Conversations 14

Conversation management APIs

GET
/api/v1/accounts/{account_id}/conversations/meta
Get Conversation Counts
conversationListMeta 6 params → 200400
GET
/api/v1/accounts/{account_id}/conversations
Conversations List
conversationList 8 params → 200400
POST
/api/v1/accounts/{account_id}/conversations
Create New Conversation
newConversation 1 param body → 200403
POST
/api/v1/accounts/{account_id}/conversations/filter
Conversations Filter
conversationFilter 2 params body → 200400
GET
/api/v1/accounts/{account_id}/conversations/{conversation_id}
Conversation Details
get-details-of-a-conversation 2 params → 200403404
PATCH
/api/v1/accounts/{account_id}/conversations/{conversation_id}
Update Conversation
update-conversation 2 params body → 200401404
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_status
Toggle Status
toggle-status-of-a-conversation 2 params body → 200404401
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_priority
Toggle Priority
toggle-priority-of-a-conversation 2 params body → 200401404
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_typing_status
Toggle Typing Status
toggle-typing-status-of-a-conversation 2 params body → 200401404
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/custom_attributes
Update Custom Attributes
update-custom-attributes-of-a-conversation 2 params body → 200401404
GET
/api/v1/accounts/{account_id}/conversations/{conversation_id}/labels
List Labels
list-all-labels-of-a-conversation 2 params → 200404401
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/labels
Add Labels
conversation-add-labels 2 params body → 200404401
GET
/api/v1/accounts/{account_id}/conversations/{conversation_id}/reporting_events
Conversation Reporting Events
get-conversation-reporting-events 2 params → 200403404
POST
/api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments
Assign a conversation to an agent or a team.
assignConversation 2 params body → 200

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are conversation (27 properties), message (22 properties), user (20 properties), reporting_event (12 properties). Each schema is shown below with its type and property counts.

user
object
20 properties
reporting_event
object
12 properties
conversation_create_payload
object
10 properties 1 required
generic_id
object
1 property
request_error
object
3 properties
conversation
object
27 properties
conversation_list
object
1 property
conversation_labels
object
1 property
message
object
22 properties
bad_request_error
object
2 properties
conversation_show
object
ConversationList
object
1 property
Conversation
object
10 properties
ConversationCreate
object
7 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

chatwoot-conversations-api-openapi.yml Raw ↑

Other APIs Chatwoot publishes across the network.

Chatwoot Client API
AE Profile APIs.io
Chatwoot Platform API
AE Profile APIs.io
Chatwoot Account AgentBots API
AE Profile APIs.io
Chatwoot Account API
AE Profile APIs.io
Chatwoot Account Users API
AE Profile APIs.io
Chatwoot Accounts API
AE Profile APIs.io
Chatwoot AgentBots API
AE Profile APIs.io
Chatwoot Agents API
AE Profile APIs.io
Chatwoot Audit Logs API
AE Profile APIs.io
Chatwoot Automation Rule API
AE Profile APIs.io
Chatwoot Canned Responses API
AE Profile APIs.io
Chatwoot Contact Labels API
AE Profile APIs.io
#Conversations
← Back to C APIs
API Details
ID
chatwoot:chatwoot-conversations-api
Base URL
https://app.chatwoot.com
Docs
https://developers.chatwoot.com/api-reference/introduction
Provider
Chatwoot
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=chatwoot-conversations-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/chatwoot-conversations-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Chatwoot Conversations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.