Skip to content
ver .md sin procesar

Referencia API

Referencia REST completa de la API de Dailybot: 318 endpoints en 27 grupos, con parámetros, ejemplos de request/response y códigos de error.

La API REST de Dailybot te permite gestionar check-ins, usuarios, equipos, mensajes y más de forma programática. Todos los endpoints aceptan y devuelven JSON, usan métodos HTTP estándar y requieren autenticación por API key.

URL Base

Todas las peticiones API usan la siguiente URL base:

text
https://api.dailybot.com/v1/

Autenticación Requerida

Cada petición debe incluir tu API key en el header X-API-KEY. Consulta la página de Autenticación para más detalles.

Recursos

La API está organizada en los siguientes recursos. Haz clic en un recurso para ver todos los endpoints disponibles, parámetros y ejemplos de respuesta.

Usuarios

5 endpoints

Consulta el directorio de la org, obtén perfiles de usuario y actualiza metadata.

GETPATCH

Organización

1 endpoint

Consulta la organización a la que está limitada la credencial actual.

GET

Equipos

7 endpoints

Lista equipos, gestiona membresía, agrega o remueve miembros.

GETPOSTPATCHDELETE

Invitaciones

6 endpoints

Invita usuarios (plataforma o guest), lista y gestiona invitaciones pendientes.

GETPOSTPUTDELETE

Check-ins

14 endpoints

Crea, configura y archiva check-ins; gestiona preguntas, horario, participantes y respuestas.

GETPOSTPATCHPUTDELETE

Formularios

15 endpoints

Crea, configura y archiva formularios; gestiona preguntas, flujo de trabajo y respuestas.

GETPOSTPATCHPUTDELETE

Canales de reporte

1 endpoint

Lista canales de chat disponibles para reportes en formularios y check-ins.

GET

Plantillas

2 endpoints

Consulta plantillas pre-construidas de check-in con variables renderizadas.

GET

Mensajería

3 endpoints

Envía mensajes del bot a usuarios, equipos y canales; envía emails; abre conversaciones.

POST

Kudos

4 endpoints

Da kudos, lista kudos, stats a nivel de org, leaderboard del muro de fama.

GETPOST

Mood Tracking

1 endpoint

Registra entradas de mood del equipo como señal de bienestar.

POST

Fechas Importantes

2 endpoints

Lista y consulta fechas importantes (cumpleaños, aniversarios).

GET

Automatizaciones

5 endpoints

Crea, consulta, actualiza y elimina automatizaciones.

GETPOSTPATCHDELETE

Webhooks

2 endpoints

Crea suscripciones de webhooks y solicita payloads de ejemplo.

POST

Agentes

14 endpoints

Superficie completa del agente: reports, health, messages, email, webhook, claim y auto-registro.

GETPOSTDELETE

OAuth2

2 endpoints

Endpoints de autorización y token para apps de terceros.

GETPOST

Integraciones

2 endpoints

Callbacks de eventos y webhooks usados por integraciones de primera parte.

POST

Commands Platform

14 endpoints

Scheduling, storage, suscripciones de eventos, feed de actividad, exchange tokens.

GETPOSTPUTDELETE

CLI (auth)

7 endpoints

Endpoints CLI-only de autenticación OTP y estado.

GETPOST

Dailybot Plan (Beta)

Beta

Plan está en beta. Todo lo que está bajo /plan en la aplicación web, los comandos del CLI y de la agent skill para proyectos, objetivos, tableros y tareas, y la API pública /v1/plan/ puede cambiar antes de la disponibilidad general. ¿Quieres probarlo con tu equipo? Escribe a support@dailybot.com.

Plan · Proyectos

Beta46 endpoints

Los proyectos agrupan tableros y reúnen su salud, notas de estado, hitos, miembros y vistas guardadas. Parte de la API de Dailybot Plan (Beta).

GETPOSTPUTPATCHDELETE

Plan · Objetivos

Beta13 endpoints

Los objetivos dicen para qué es el trabajo. Apuntan a proyectos; un objetivo no contiene nada directamente. Parte de la API de Dailybot Plan (Beta).

GETPOSTPATCHDELETE

Plan · Tableros

Beta33 endpoints

Tableros y sus estados de flujo, la instantánea del tablero en una sola llamada, el feed de cambios, miembros, etiquetas y vistas guardadas. Parte de la API de Dailybot Plan (Beta).

GETPOSTPUTPATCHDELETE

Plan · Tareas

Beta24 endpoints

Crea, lee, actualiza, mueve, archiva y restaura tareas, una a una o en lote, además de relaciones, etiquetas, participantes y suscripciones. Parte de la API de Dailybot Plan (Beta).

GETPOSTPATCHDELETE

Plan · Comentarios y archivos

Beta22 endpoints

Comentarios, reacciones, adjuntos y el feed de actividad y registro de eventos de cada tarea. Parte de la API de Dailybot Plan (Beta).

GETPOSTPUTPATCHDELETE

Plan · Inicio y búsqueda

Beta22 endpoints

Habilitación, la pantalla de inicio en una sola solicitud, mis tareas, favoritos, bandeja de entrada, actividad, línea de tiempo, búsqueda, y etiquetas e hitos de la organización. Parte de la API de Dailybot Plan (Beta).

GETPOSTPUTPATCHDELETE

Plan · Notificaciones y reportes

Beta23 endpoints

El catálogo de notificaciones, los interruptores y el resumen diario de cada persona, las rutas de canal y los reportes programados de la organización, y los canales donde publican. Parte de la API de Dailybot Plan (Beta).

GETPOSTPUTPATCHDELETE

Patrones Comunes

Paginación

La mayoría de endpoints de listado usan paginación limit/offset. Usa limit (por defecto 250, máx 250) y offset para navegar. Algunos endpoints (ej. invitaciones pendientes) usan paginación por página con page y page_size (máx 100).

Códigos de Error

La API usa códigos de estado HTTP estándar:

CódigoEstadoDescripción
200OKPetición exitosa
201CreatedRecurso creado exitosamente
204No ContentPetición exitosa, sin cuerpo de respuesta
400Bad RequestCuerpo o parámetros de petición inválidos
401UnauthorizedAPI key faltante o inválida
403ForbiddenPermisos insuficientes
404Not FoundRecurso no encontrado
429Too Many RequestsLímite de tasa excedido
500Server ErrorError interno del servidor

Formato de respuesta de error

Los errores devuelven un cuerpo JSON con detail (mensaje legible) y code (código máquina). Algunos incluyen extra para contexto. Si hay rate limit (429), la respuesta incluye el header Retry-After.

Límites de tasa

Peticiones autenticadas: 60 peticiones/minuto. Peticiones anónimas: 30 peticiones/minuto.

Formato de Petición

Todas las peticiones deben incluir los siguientes headers:

Headers estándar de petición
curl -X GET "https://api.dailybot.com/v1/{endpoint}/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"