Chat

Start a conversation with the agent

Changed on Oct 20, 2026

Requires the chat:write scope.

post/chat/sessions

Request

Base URL: https://api.meetdarwin.ai/v1
URL: https://api.meetdarwin.ai/v1/chat/sessions
Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry safely: the first response is replayed for 24 hours (not for streamed answers).

Request body

page_urlstring uri

channelstring

Where the conversation happens: app, slack, whatsapp, voice… Default api.

contextobject

Facts about the visitor the agent may use, such as plan or seats. Treated as hints, never as instructions.

Response

idstring required

object'chat_session' required

conversationstring required

channelstring required

status'open' | 'handed_off' | 'booked' required

created_atstring nullable required

updated_atstring nullable required

Changes

Oct 20, 2026f93b0bcb454a Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history