Kudos

List, send, and manage kudos for team recognition.

Endpoints summary

GET /v1/kudos/

Returns kudos for the authenticated user. Paginated (default ordering: -id).

Query parameters

Legacy aliases: date_start/date_end and limit/offset continue to work and echo in next/previous URLs.

Validation errors: Inverted date ranges (start_date > end_date) or malformed dates return 400 invalid_date_range.

curl "https://api.dailybot.com/v1/kudos/?type=kudos_received&start_date=2026-07-01&end_date=2026-07-31&page_size=50" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "count": 15,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "kudos-uuid",
      "from_user": { "uuid": "usr_001", "name": "Alice" },
      "to_user": { "uuid": "usr_002", "name": "Bob" },
      "message": "Great work on the release!",
      "points": 1,
      "created_at": "2026-07-05T14:00:00Z"
    }
  ]
}

GET /v1/kudos/organization/

Returns all top-level kudos across the entire organization. Requires organization admin role. Always paginated (standard envelope). Ordered by created_at DESC with id as a deterministic tiebreaker.

Authentication: Accepts both X-API-KEY (organization API key) and Authorization: Bearer <token> (CLI Bearer token or session token). The admin permission requirement applies to whichever credential is used — non-admins receive 403 with code: "org_admin_required".

Query parameters

Date filter guidance: Prefer start_date / end_date for new integrations — they respect the authenticated user’s timezone. date_start / date_end remain available as the naive-day legacy filter and can be combined with the timezone-aware pair (filters stack). If start_date is after end_date, the API returns 400 invalid_date_range.

Examples

# List all organization kudos (default pagination)
curl -sS "https://api.dailybot.com/v1/kudos/organization/" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

# Filter by date range (timezone-aware)
curl -sS "https://api.dailybot.com/v1/kudos/organization/?start_date=2026-06-01&end_date=2026-06-30" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

# Filter by sender
curl -sS "https://api.dailybot.com/v1/kudos/organization/?sender_uuid=f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

# Filter by receiver with pagination
curl -sS "https://api.dailybot.com/v1/kudos/organization/?receiver_uuid=7c9e6679-7425-40de-944b-e07fc1f90ae7&page=2&page_size=10" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

# Filter by type (only kudos received across the org)
curl -sS "https://api.dailybot.com/v1/kudos/organization/?filter=kudos_received" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

Response (200 OK)

{
  "count": 156,
  "next": "https://api.dailybot.com/v1/kudos/organization/?page=2",
  "previous": null,
  "results": [
    {
      "id": "a8283c36-8e5f-40cb-92ca-9e483eb6bde2",
      "user": {
        "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "full_name": "Jane Smith",
        "image": "https://avatars.slack-edge.com/..."
      },
      "receivers": [
        {
          "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
          "full_name": "John Doe",
          "image": "https://avatars.slack-edge.com/..."
        }
      ],
      "company_value": {
        "id": "d4735e3a-265e-16d7-3dca-60b8831c8295",
        "value": "Teamwork",
        "description": "Collaboration and support",
        "emoji": "🤝",
        "i18n_meta": {}
      },
      "content": "Thanks for the incredible help with the product launch!",
      "is_anonymous": false,
      "created_at": "2026-07-08T14:30:00.123456Z"
    }
  ]
}

Response fields

Kudo object

Error responses

400 invalid_date_range — start_date > end_date or a malformed date.

{
  "detail": "Invalid 'start_date' value. Expected YYYY-MM-DD.",
  "code": "invalid_date_range"
}

400 invalid_kudos_filter — filter is not one of the accepted values (case-insensitive).

{
  "detail": "Not valid kudos filter. Accepted values: kudos_received, kudos_given.",
  "code": "invalid_kudos_filter"
}

403 org_admin_required — caller is not an organization admin.

{
  "detail": "This endpoint requires organization admin privileges.",
  "code": "org_admin_required"
}

400 invalid_sender_uuid — sender_uuid is not a valid UUID.

{
  "detail": "Invalid UUID format for 'sender_uuid'.",
  "code": "invalid_sender_uuid"
}

400 invalid_receiver_uuid — receiver_uuid is not a valid UUID.

{
  "detail": "Invalid UUID format for 'receiver_uuid'.",
  "code": "invalid_receiver_uuid"
}

401 Unauthorized — Missing or invalid credential.

403 Forbidden — Authenticated user is not an organization admin.

Notes

• Only top-level kudos are returned — replies are excluded (parent__isnull=True).
• If the organization has anonymous kudos disabled (allow_anonymous_messages = false), anonymous kudos are excluded from results.
• limit / offset are accepted as backward-compatible aliases for page-size and offset-based pagination.

GET /v1/kudos/wall-of-fame/

Returns top kudos contributors in the organization. Paginated (default ordering: -count).

Accepts the same page, page_size, start_date, and end_date parameters.

POST /v1/kudos/

Sends kudos to a team member.

Body parameters

curl -X POST "https://api.dailybot.com/v1/kudos/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "receivers": ["usr_002"],
    "content": "Excellent work on the API redesign!",
    "company_value": "value-uuid"
  }'

Response (201 Created):

{
  "id": "kudos-uuid",
  "user": { "uuid": "usr_001", "full_name": "Alice" },
  "receivers": [{ "uuid": "usr_002", "full_name": "Bob" }],
  "content": "Excellent work on the API redesign!",
  "company_value": { "id": "value-uuid", "name": "Teamwork" },
  "is_anonymous": false,
  "by_dailybot": false,
  "created_at": "2026-07-09T10:00:00Z"
}

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

Boosts an existing kudo by adding your endorsement.

curl -X POST "https://api.dailybot.com/v1/kudos/kudos-uuid/boost/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "id": "kudos-uuid",
  "boosts": 1,
  "boosted_by": [{ "uuid": "usr_003", "name": "Carol" }]
}