Mood

List mood check-ins

get

https://api.therappai.com/api/v1https://staging-api.therappai.com/api/v1

/mood/checkin/

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

fromstring · dateOptional

tostring · dateOptional

pageintegerOptional

Responses

200

Mood check-ins

application/json

401

Unauthorized – missing or invalid access token

application/json

get

/mood/checkin/

HTTPcURLJavaScriptPython

GET /api/v1/mood/checkin/ HTTP/1.1
Host: api.therappai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "mood_value": 1,
    "slider_value": 1,
    "note": "text",
    "created_at": "2026-01-16T04:21:35.313Z"
  }
]

Create mood check-in

post

https://api.therappai.com/api/v1https://staging-api.therappai.com/api/v1

/mood/checkin/

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

mood_valueintegerRequired

slider_valueinteger | nullableOptional

notestring | nullableOptional

Responses

201

Mood check-in created

application/json

401

Unauthorized – missing or invalid access token

application/json

post

/mood/checkin/

HTTPcURLJavaScriptPython

POST /api/v1/mood/checkin/ HTTP/1.1
Host: api.therappai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "mood_value": 1,
  "slider_value": 1,
  "note": "text"
}

{
  "id": 1,
  "mood_value": 1,
  "slider_value": 1,
  "note": "text",
  "created_at": "2026-01-16T04:21:35.313Z"
}

Mood over time

get

https://api.therappai.com/api/v1https://staging-api.therappai.com/api/v1

/mood/insights/mood-over-time/

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

daysintegerOptional

Responses

200

Mood trend data

No content

401

Unauthorized – missing or invalid access token

application/json

get

/mood/insights/mood-over-time/

HTTPcURLJavaScriptPython

GET /api/v1/mood/insights/mood-over-time/ HTTP/1.1
Host: api.therappai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Mood summary

get

https://api.therappai.com/api/v1https://staging-api.therappai.com/api/v1

/mood/insights/summary/

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

rangestring · enumOptionalPossible values:

Responses

200

Mood summary

No content

401

Unauthorized – missing or invalid access token

application/json

get

/mood/insights/summary/

HTTPcURLJavaScriptPython

GET /api/v1/mood/insights/summary/ HTTP/1.1
Host: api.therappai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Mood calendar view

get

https://api.therappai.com/api/v1https://staging-api.therappai.com/api/v1

/mood/insights/calendar/

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

yearintegerOptional

monthintegerOptional

Responses

200

Calendar data

No content

401

Unauthorized – missing or invalid access token

application/json

get

/mood/insights/calendar/

HTTPcURLJavaScriptPython

GET /api/v1/mood/insights/calendar/ HTTP/1.1
Host: api.therappai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content