Kudos

Kudos are Dailybot's recognition system for celebrating team achievements. Use this endpoint to programmatically award kudos to team members, supporting anonymous recognition and company values.

Method	Endpoint	Description
GET	/v1/kudos/	List kudos (paginated)
POST	/v1/kudos/	Create a kudo
POST	/v1/kudos/{kudo-id}/boost/	Boost a kudo

List Kudos

GET /v1/kudos/

Returns a paginated list of kudos (filtered by the authenticated user: received or given).

Query Parameters

Name	Type	Required	Description
`filter`	string	Optional	kudos_received (default) or kudos_given.
`limit`	integer	Optional	Max results per page (pagination).
`offset`	integer	Optional	Number of results to skip (pagination).

Request

curl "https://api.dailybot.com/v1/kudos/?filter=kudos_received&limit=10&offset=0" \
  -H "X-API-KEY: your_api_key"

Response 200 OK

json

{
  "count": 10,
  "next": "https://api.dailybot.com/v1/kudos/?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "id": "kudo-uuid",
      "parent": null,
      "user": {
        "uuid": "user-uuid",
        "full_name": "Jane Smith",
        "image": "...",
        "role": "member"
      },
      "receivers": [
        {
          "uuid": "user-uuid-2",
          "full_name": "John Doe"
        }
      ],
      "company_value": {
        "id": "value-uuid",
        "name": "Teamwork"
      },
      "content": "Great work on the release!",
      "is_anonymous": false,
      "by_dailybot": false,
      "metadata": {},
      "created_at": "2026-02-25T10:00:00Z"
    }
  ]
}

Send Kudos

POST /v1/kudos/

Creates a new kudo. Provide either receivers (list of identifiers) or both users_receivers and/or teams_receivers.

Body Parameters

Name	Type	Required	Description
`receivers`	array of strings	Optional	User identifiers (e.g. UUIDs) to receive the kudo. Required if users_receivers and teams_receivers are not used.
`users_receivers`	array of strings (UUID)	Optional	User UUIDs to receive the kudo.
`teams_receivers`	array of strings (UUID)	Optional	Team UUIDs; all active members receive the kudo.
`content`	string	Optional	Kudo message text (HTML-safe).
`is_anonymous`	boolean	Optional	If true, sender is anonymized. Default: false.
`company_value`	string (UUID)	Optional	Company value ID to attach (if organization uses values).

Request

curl -X POST "https://api.dailybot.com/v1/kudos/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "receivers": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "content": "Great work on the API integration! Ship it!",
    "company_value": "value-uuid-here",
    "is_anonymous": false
  }'

Response 200 OK

json

{
  "id": "kudo-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "Jane Smith"
  },
  "receivers": [
    {
      "uuid": "user-uuid-2",
      "full_name": "John Doe"
    }
  ],
  "company_value": {
    "id": "value-uuid",
    "name": "Teamwork"
  },
  "content": "Great work!",
  "is_anonymous": false,
  "by_dailybot": false,
  "created_at": "2026-02-25T10:00:00Z",
  "children_kudos": [],
  "boost_count": 0,
  "has_boosted": false
}

Response 400 Bad Request

json

{
  "detail": "The receivers list should not be empty",
  "code": "params_validation_error"
}

Response 400 Bad Request — self-kudo

json

{
  "detail": "You cannot give kudos to yourself",
  "code": "cant_give_kudos_to_yourself"
}

Response 404 Not Found

json

{
  "detail": "One or more receivers were not found in Dailybot, or were duplicated in the input",
  "code": "no_users_found"
}

Tip

You can send kudos to multiple users at once by including multiple UUIDs in the receivers array. Each recipient will receive their own kudos notification.

Info

When using an exchange token, kudos will appear as sent by the user associated with the token rather than the API key owner.

Boost a kudo

POST /v1/kudos/{kudo-id}/boost/

Boosts a kudo (adds a '+1' from the authenticated user). Only original (top-level) kudos can be boosted; the user cannot boost their own kudo or boost the same kudo twice.

Request

curl -X POST "https://api.dailybot.com/v1/kudos/kudo-uuid-here/boost/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json"

Response 201 Created

json

{
  "id": "boost-kudo-uuid",
  "parent": "kudo-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "Jane Smith"
  },
  "created_at": "2026-02-25T10:05:00Z",
  "boost_count": 1
}

Response 400 Bad Request

json

{
  "detail": "You cannot boost your own kudo.",
  "code": "cannot_boost_own_kudo"
}

Response 400 Bad Request — boosting a boost

json

{
  "detail": "You can only boost original kudos.",
  "code": "cannot_boost_child_kudo"
}

Response 404 Not Found

json

{
  "detail": "Not found.",
  "code": "not_found"
}

Response 409 Conflict

json

{
  "detail": "You have already boosted this kudo.",
  "code": "already_boosted"
}

Rate Limits

Max 10 kudos per day per API key. Minimum 5 minutes between kudos.