Send Message
Sends one or more text messages in a consultation, written in the first person as the patient speaking.
A send must be made with the newest message in hand: pass lastSeenMessageId, or read GET /api/consultations/ first. A stale send is refused with status READ_REQUIRED and the latest conversation state inline.
With waitForReply (the default) the response also carries whatever happens next: the reply, a provider connecting, or the payment gate when the send completed triage.
Authorizations
OAuth 2.1 with PKCE
Path Parameters
Consultation/conversation ID
Body
Array of message texts to send
Single message text (alternative to messages array)
Newest message id you have seen. Satisfies the read-first gate without a separate read; a stale value is refused.
Wait up to ~55s for the next reply and return it inline. On timeout the response carries stillWaiting - the message is already sent, so never re-send.
Response
Message sent
False on a READ_REQUIRED or PAYMENT_REQUIRED refusal
Conversation status, or READ_REQUIRED / PAYMENT_REQUIRED on a refusal
A message in a consultation
The wait timed out; the message is sent, keep waiting
A provider joined while waiting (status WITH_PROVIDER)
The status the conversation moved to during the wait
The send completed triage, so the patient must confirm payment
Payment gate information when triage is complete
On READ_REQUIRED, retry with this as lastSeenMessageId
Full conversation details with messages
Patient-facing wording to relay
Suggested follow-up call
Arguments to pass to nextStep