Plataforma de comandos

Endpoints públicos de la API para ejecución programada de comandos, almacenamiento, suscripción a eventos, seguimiento de actividad y obtención de un token de intercambio. Todos requieren el header X-API-KEY. Muchos endpoints requieren un token de intercambio (del contexto del comando o de POST /v1/auth/fetch-command-exchange-token/).

Resumen de endpoints

Programación

POST /v1/scheduler/

Programa un comando para ejecutarse en un momento futuro.

curl -X POST "https://api.dailybot.com/v1/scheduler/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "command_intent": "send_report",
    "run_at": "2026-04-10T09:00:00Z",
    "user_uuid": "user-uuid",
    "params": { "report_type": "weekly" }
  }'

Respuesta (201 Created):

{
  "id": "job-uuid",
  "command_intent": "send_report",
  "run_at": "2026-04-10T09:00:00Z",
  "status": "scheduled"
}

GET /v1/scheduler/

Lista todos los trabajos de comandos programados para la organización.

curl -X GET "https://api.dailybot.com/v1/scheduler/" \
  -H "X-API-KEY: tu_api_key"

DELETE /v1/scheduler/{id}/

Cancela un trabajo programado.

curl -X DELETE "https://api.dailybot.com/v1/scheduler/job-uuid/" \
  -H "X-API-KEY: tu_api_key"

Almacenamiento

POST /v1/storage/

Escribe un par clave-valor. Los datos tienen ámbito para el usuario y la organización.

curl -X POST "https://api.dailybot.com/v1/storage/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"key": "user_preferences", "value": {"theme": "dark"}}'

GET /v1/storage/{key}/

Lee un par clave-valor.

curl -X GET "https://api.dailybot.com/v1/storage/user_preferences/" \
  -H "X-API-KEY: tu_api_key"

Respuesta (200 OK):

{ "key": "user_preferences", "value": { "theme": "dark" } }

DELETE /v1/storage/{key}/

Elimina un par clave-valor.

curl -X DELETE "https://api.dailybot.com/v1/storage/user_preferences/" \
  -H "X-API-KEY: tu_api_key"

Suscripción a eventos

POST /v1/events/subscribe/

Suscribe a un tipo de evento para el usuario autenticado.

curl -X POST "https://api.dailybot.com/v1/events/subscribe/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"event_type": "check_in.completed", "webhook_url": "https://tu-app.com/eventos"}'

DELETE /v1/events/subscribe/{id}/

Cancela la suscripción a un evento.

curl -X DELETE "https://api.dailybot.com/v1/events/subscribe/sub-uuid/" \
  -H "X-API-KEY: tu_api_key"

Actividad

POST /v1/activity/

Envía una entrada de actividad vinculada al usuario autenticado.

curl -X POST "https://api.dailybot.com/v1/activity/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "activity_type": "commit",
    "description": "Pushed 3 commits to main",
    "metadata": { "repo": "my-repo", "commits": 3 }
  }'

Respuesta (201 Created):

{
  "id": "activity-uuid",
  "activity_type": "commit",
  "description": "Pushed 3 commits to main",
  "created_at": "2026-04-06T10:00:00Z"
}

POST /v1/auth/fetch-command-exchange-token/

Obtiene un token de intercambio que permite hacer llamadas API en nombre de un usuario específico. Requiere que tu API key tenga los permisos necesarios.

curl -X POST "https://api.dailybot.com/v1/auth/fetch-command-exchange-token/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"user_uuid": "target-user-uuid"}'

Respuesta (200 OK):

{
  "exchange_token": "eyJ...",
  "expires_at": "2026-04-06T11:00:00Z"
}

La autenticación por Token de Intercambio está deshabilitada por defecto. Contacta a soporte para habilitarla en tu organización.