Kudos

Los Kudos son el sistema de reconocimiento de Dailybot para celebrar los logros del equipo. Usa este endpoint para otorgar kudos a miembros del equipo programáticamente, con soporte para reconocimiento anónimo y valores de empresa.

Método	Endpoint	Descripción
GET	/v1/kudos/	Listar kudos (paginado)
POST	/v1/kudos/	Crear un kudo
POST	/v1/kudos/{kudo-id}/boost/	Dar boost a un kudo

Listar Kudos

GET /v1/kudos/

Devuelve una lista paginada de kudos (filtrada por el usuario autenticado: recibidos o dados).

Parámetros de Consulta

Name	Type	Required	Description
`filter`	string	Optional	kudos_received (por defecto) o kudos_given.
`limit`	integer	Optional	Máximo de resultados por página (paginación).
`offset`	integer	Optional	Número de resultados a omitir (paginación).

Petición

curl "https://api.dailybot.com/v1/kudos/?filter=kudos_received&limit=10&offset=0" \
  -H "X-API-KEY: tu_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": "María García",
        "image": "...",
        "role": "member"
      },
      "receivers": [
        {
          "uuid": "user-uuid-2",
          "full_name": "Carlos López"
        }
      ],
      "company_value": {
        "id": "value-uuid",
        "name": "Trabajo en equipo"
      },
      "content": "¡Gran trabajo en el release!",
      "is_anonymous": false,
      "by_dailybot": false,
      "metadata": {},
      "created_at": "2026-02-25T10:00:00Z"
    }
  ]
}

Enviar Kudos

POST /v1/kudos/

Crea un nuevo kudo. Proporciona receivers (lista de identificadores) o users_receivers y/o teams_receivers.

Parámetros del Cuerpo

Name	Type	Required	Description
`receivers`	array of strings	Optional	Identificadores de usuario (ej. UUIDs) que reciben el kudo. Requerido si no se usan users_receivers y teams_receivers.
`users_receivers`	array of strings (UUID)	Optional	UUIDs de usuarios que reciben el kudo.
`teams_receivers`	array of strings (UUID)	Optional	UUIDs de equipos; todos los miembros activos reciben el kudo.
`content`	string	Optional	Texto del mensaje del kudo (HTML-safe).
`is_anonymous`	boolean	Optional	Si es true, el remitente se anonimiza. Por defecto: false.
`company_value`	string (UUID)	Optional	ID del valor de empresa a asociar (si la organización usa valores).

Petición

curl -X POST "https://api.dailybot.com/v1/kudos/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "receivers": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "content": "Excelente trabajo en la integración API!",
    "company_value": "value-uuid-aqui",
    "is_anonymous": false
  }'

Response 200 OK

json

{
  "id": "kudo-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "María García"
  },
  "receivers": [
    {
      "uuid": "user-uuid-2",
      "full_name": "Carlos López"
    }
  ],
  "company_value": {
    "id": "value-uuid",
    "name": "Trabajo en equipo"
  },
  "content": "¡Gran trabajo!",
  "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

Puedes enviar kudos a múltiples usuarios a la vez incluyendo varios UUIDs en el array receivers. Cada destinatario recibirá su propia notificación de kudos.

Info

Al usar un token de intercambio, los kudos aparecerán como enviados por el usuario asociado al token en lugar del propietario de la API key.

Boost a un kudo

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

Da boost a un kudo (añade un '+1' del usuario autenticado). Solo se pueden boostear kudos originales (de nivel superior); el usuario no puede boostear su propio kudo ni el mismo kudo dos veces.

Petición

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

Response 201 Created

json

{
  "id": "boost-kudo-uuid",
  "parent": "kudo-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "María García"
  },
  "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 — boostear un 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"
}

Límites de Tasa

Max 10 kudos por día por API key. Mínimo 5 minutos entre kudos.