Plataforma de comandos

Endpoints públicos da API para execução agendada de comandos, armazenamento, assinatura de eventos, rastreamento de atividade e obtenção de um token de troca. Todos requerem o header X-API-KEY. Muitos endpoints requerem um token de troca (do contexto do comando ou de POST /v1/auth/fetch-command-exchange-token/).

Resumo dos endpoints

Agendamento

POST /v1/scheduler/

Agenda um comando para rodar em um momento futuro.

curl -X POST "https://api.dailybot.com/v1/scheduler/" \
  -H "X-API-KEY: sua_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" }
  }'

Resposta (201 Created):

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

GET /v1/scheduler/

Lista todos os trabalhos de comandos agendados para a organização.

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

DELETE /v1/scheduler/{id}/

Cancela um trabalho agendado.

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

Armazenamento

POST /v1/storage/

Escreve um par chave-valor. Os dados têm escopo para o usuário e a organização.

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

GET /v1/storage/{key}/

Lê um par chave-valor.

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

Resposta (200 OK):

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

DELETE /v1/storage/{key}/

Exclui um par chave-valor.

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

Assinatura de eventos

POST /v1/events/subscribe/

Assina um tipo de evento para o usuário autenticado.

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

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

Cancela a assinatura de um evento.

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

Atividade

POST /v1/activity/

Envia uma entrada de atividade vinculada ao usuário autenticado.

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

Resposta (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/

Obtém um token de troca que permite fazer chamadas de API em nome de um usuário específico. Requer que sua API key tenha as permissões necessárias.

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

Resposta (200 OK):

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

A autenticação por Token de Troca está desabilitada por padrão. Entre em contato com o suporte para habilitá-la na sua organização.