Skip to main content
POST
/
rest
/
consultations
Start a new consultation
curl --request POST \
  --url https://mcp.arlohealth.ai/rest/consultations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "contextMessage": "I've had a sore throat for 3 days and it hurts to swallow."
}
EOF
{
  "conversationId": "<string>",
  "status": "TRIAGING",
  "triageResponse": "<string>"
}

Authorizations

​
Authorization
string
header
required

OAuth 2.1 with PKCE

Body

application/json
​
contextMessage
string
required

First-person narrative of the health concern

Example:

"I've had a sore throat for 3 days and it hurts to swallow."

Response

Consultation started

​
conversationId
string
​
status
enum<string>
  • TRIAGING: AI is gathering information
  • PAYMENT_REQUIRED: Triage complete, awaiting payment
  • MATCHING: Being matched with provider
  • ACTIVE: Connected with provider
  • CLOSED: Consultation completed
  • EMERGENCY: Urgent care advised
  • CANCELED: User canceled
  • NOT_STARTED: Not yet started
Available options:
TRIAGING,
PAYMENT_REQUIRED,
MATCHING,
ACTIVE,
CLOSED,
EMERGENCY,
CANCELED,
NOT_STARTED
​
triageResponse
string

AI's initial response or follow-up question