Kudos

Lista, envía y gestiona kudos para el reconocimiento del equipo.

Resumen de endpoints

GET /v1/kudos/organization/

Devuelve todos los kudos de nivel superior de toda la organización. Requiere rol de admin de la organización. Siempre paginado (envelope estándar). Ordenado por created_at DESC con id como criterio de desempate determinista.

Autenticación: Acepta tanto X-API-KEY (API key de organización) como Authorization: Bearer <token> (token Bearer del CLI o de sesión). El requisito de admin aplica a cualquiera de las dos credenciales — los no-admin reciben 403 con code: "org_admin_required".

Parámetros de query

Guía sobre filtros de fecha: Prefiere start_date / end_date para integraciones nuevas — respetan la zona horaria del usuario autenticado. date_start / date_end siguen disponibles como filtros legacy ingenuos por día y pueden combinarse con la pareja timezone-aware (los filtros se acumulan). Si start_date es posterior a end_date, la API devuelve 400 invalid_date_range.

Ejemplos

# Listar todos los kudos de la organización (paginación por defecto)
curl -sS "https://api.dailybot.com/v1/kudos/organization/" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

# Filtrar por rango de fechas (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"

# Filtrar por emisor
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 con paginación
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 (solo kudos recibidos en toda la organización)
curl -sS "https://api.dailybot.com/v1/kudos/organization/?filter=kudos_received" \
  -H "Authorization: Bearer $DAILYBOT_CLI_TOKEN"

Respuesta (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": "Colaboración y apoyo",
        "emoji": "🤝",
        "i18n_meta": {}
      },
      "content": "¡Gracias por la ayuda increíble en el lanzamiento del producto!",
      "is_anonymous": false,
      "created_at": "2026-07-08T14:30:00.123456Z"
    }
  ]
}

Campos de la respuesta

Objeto kudo

Respuestas de error

400 invalid_date_range — start_date > end_date o fecha mal formada.

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

400 invalid_kudos_filter — filter no es uno de los valores aceptados (sin distinción de mayúsculas).

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

403 org_admin_required — el llamante no es admin de la organización.

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

400 invalid_sender_uuid — sender_uuid no es un UUID válido.

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

400 invalid_receiver_uuid — receiver_uuid no es un UUID válido.

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

401 Unauthorized — Credencial ausente o inválida.

403 Forbidden — Usuario autenticado sin rol de admin de la organización.

Notas

• Solo se devuelven kudos de nivel superior — las respuestas se excluyen (parent__isnull=True).
• Si la organización tiene los kudos anónimos deshabilitados (allow_anonymous_messages = false), los kudos anónimos se excluyen de los resultados.
• limit / offset se aceptan como aliases retrocompatibles para page_size y paginación por offset.

GET /v1/kudos/

Devuelve kudos del usuario autenticado. Paginado (ordenación por defecto: -id).

Parámetros de query

Errores de validación: Rangos invertidos (start_date > end_date) o fechas mal formadas devuelven 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"

Respuesta (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": "¡Gran trabajo en el release!",
      "points": 1,
      "created_at": "2026-07-05T14:00:00Z"
    }
  ]
}

POST /v1/kudos/

Envía kudos a un miembro del equipo.

Parámetros del 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 trabajo en el rediseño de la API!",
    "company_value": "value-uuid"
  }'