Mood Tracking
Public API for reading and submitting mood (motivation) scores. Get the authenticated user's mood entry for a date or submit a new score. All requests require the X-API-KEY header.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/mood/track/ | Get the authenticated user's mood entry for a date |
| POST | /v1/mood/track/ | Submit a mood (motivation) score for a date |
GET /v1/mood/track/
GET
/v1/mood/track/ Returns the authenticated user's mood entry for a given date.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | Optional | Date in YYYY-MM-DD format. Default: today (in user's timezone). |
curl "https://api.dailybot.com/v1/mood/track/" -H "X-API-KEY: your_api_key_here"Response 200 OK
{
"motivation": {
"score": 4,
"created_at": "2026-02-25T14:30:00Z"
}
}Response 200 OK — No entry for date
{
"motivation": null
}POST /v1/mood/track/
POST
/v1/mood/track/ Submits a mood (motivation) score for a date. At most one entry per user per date; submitting again for the same date returns 409.
Body Parameters
| Name | Type | Required | Description |
|---|---|---|---|
score | integer | Required | Mood score; must be between 1 and 5 (inclusive). |
date | string | Optional | Date in YYYY-MM-DD format. Default: today (in user's timezone). |
curl -X POST "https://api.dailybot.com/v1/mood/track/" -H "X-API-KEY: your_api_key_here" -H "Content-Type: application/json" -d '{"score": 4}'Response 200 OK
{
"details": "The mood response has been tracked"
}Response 400 Bad Request
{
"details": "You gave 0 - and score should be between 1 and 5",
"code": "invalid_score"
}Response 409 Conflict
{
"detail": "Motivation score already completed.",
"code": "motivation_score_already_completed"
}