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/API keyCLI Auth

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).

Request

curl "https://api.dailybot.com/v1/mood/track/" -H "X-API-KEY: your_api_key_here"

Response200 OK

json

{
  "motivation": {
    "score": 4,
    "created_at": "2026-02-25T14:30:00Z"
  }
}

Response200 OK — No entry for date

json

{
  "motivation": null
}

POST /v1/mood/track/

POST/v1/mood/track/API keyCLI Auth

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).

Request

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}'

Response200 OK

json

{
  "details": "The mood response has been tracked"
}

Response400 Bad Request

json

{
  "details": "You gave 0 - and score should be between 1 and 5",
  "code": "invalid_score"
}

Response409 Conflict

json

{
  "detail": "Motivation score already completed.",
  "code": "motivation_score_already_completed"
}