Kudos

Liste, envie e gerencie kudos para o reconhecimento da equipe.

Resumo de endpoints

GET /v1/kudos/organization/

Retorna todos os kudos de nível superior de toda a organização. Requer papel de admin da organização. Sempre paginado (envelope padrão). Ordenado por created_at DESC com id como critério de desempate determinístico.

Autenticação: Aceita tanto X-API-KEY (chave de API da organização) quanto Authorization: Bearer <token> (token Bearer do CLI ou de sessão). O requisito de admin se aplica a qualquer credencial usada — não-admins recebem 403 com code: "org_admin_required".

Parâmetros de query

Orientação sobre filtros de data: Prefira start_date / end_date para novas integrações — respeitam o fuso horário do usuário autenticado. date_start / date_end permanecem disponíveis como filtro legado ingênuo por dia e podem ser combinados com o par com fuso horário (os filtros se acumulam). Se start_date for posterior a end_date, a API retorna 400 invalid_date_range.

Exemplos

# Listar todos os kudos da organização (paginação padrão)
curl -sS "https://api.dailybot.com/v1/kudos/organization/" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

# Filtrar por intervalo de datas (com fuso horário)
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"

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

# Filtrar por receptor com paginação
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"

# Filtrar por tipo (apenas kudos recebidos em toda a organização)
curl -sS "https://api.dailybot.com/v1/kudos/organization/?filter=kudos_received" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

Resposta (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": "Colaboração e apoio",
        "emoji": "🤝",
        "i18n_meta": {}
      },
      "content": "Obrigado pela ajuda incrível no lançamento do produto!",
      "is_anonymous": false,
      "created_at": "2026-07-08T14:30:00.123456Z"
    }
  ]
}

Campos da resposta

Objeto kudo

Respostas de erro

400 invalid_date_range — start_date > end_date ou data mal formada.

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

400 invalid_kudos_filter — filter não é um dos valores aceitos (sem distinção de maiúsculas).

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

403 org_admin_required — o chamador não é admin da organização.

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

400 invalid_sender_uuid — sender_uuid não é um UUID válido.

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

400 invalid_receiver_uuid — receiver_uuid não é um UUID válido.

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

401 Unauthorized — Credencial ausente ou inválida.

403 Forbidden — Usuário autenticado sem papel de admin da organização.

Notas

• Apenas kudos de nível superior são retornados — as respostas são excluídas (parent__isnull=True).
• Se a organização tem kudos anônimos desabilitados (allow_anonymous_messages = false), kudos anônimos são excluídos dos resultados.
• limit / offset são aceitos como aliases retrocompatíveis para page_size e paginação por offset.

GET /v1/kudos/

Retorna kudos do usuário autenticado. Paginado (ordenação padrão: -id).

Parâmetros de query

Erros de validação: Intervalos invertidos (start_date > end_date) ou datas mal formadas retornam 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"

Resposta (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": "Ótimo trabalho no release!",
      "points": 1,
      "created_at": "2026-07-05T14:00:00Z"
    }
  ]
}

POST /v1/kudos/

Envia kudos a um membro da equipe.

Parâmetros do body

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": "Excelente trabalho no redesign da API!",
    "company_value": "value-uuid"
  }'