Start an AI Coach chat - TeraRx API

Start an AI Coach chat

curl --request POST \
  --url https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "title": "Dinner ideas"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({title: 'Dinner ideas'})
};

fetch('https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations"

payload = { "title": "Dinner ideas" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "0190f5cc-3c4d-7e5f-8061-7a8b9c0d1e23",
  "title": "Dinner ideas",
  "created_at": "2026-10-26T11:00:00Z",
  "last_message_at": null
}

POST

/

v1

/

patient

/

ai-coach

/

conversations

Start an AI Coach chat

curl --request POST \
  --url https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "title": "Dinner ideas"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({title: 'Dinner ideas'})
};

fetch('https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://sandbox.rx.tera.health/v1/patient/ai-coach/conversations"

payload = { "title": "Dinner ideas" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "0190f5cc-3c4d-7e5f-8061-7a8b9c0d1e23",
  "title": "Dinner ideas",
  "created_at": "2026-10-26T11:00:00Z",
  "last_message_at": null
}

Authorizations

Authorization

string

header

default:Bearer sandbox_any_token_works

required

A 15-minute token bound to one patient and one enrollment, issued by POST /v1/oauth/token with the token-exchange grant. Treat it as opaque. When it expires, exchange a fresh assertion; there is no refresh token.

Headers

Idempotency-Key

string

required

A unique key per logical request, for example a UUID. Retrying with the same key and the same body within 24 hours returns the first response (with Idempotent-Replayed: true) instead of creating a duplicate. The same key with a different body is refused with 422 idempotency_key_reused.

Required string length: 8 - 255

Body

application/json

title

string

Maximum string length: 120

Example:

"Dinner ideas"

Response

Created.

id

string<uuid>

required

Example:

"0190f5cc-3c4d-7e5f-8061-7a8b9c0d1e23"

created_at

string<date-time>

required

ISO 8601 in UTC.

Example:

"2026-10-26T14:05:00Z"

title

string | null

Example:

"Dinner ideas"

last_message_at

string<date-time> | null

Example:

"2026-10-26T11:01:30Z"