Commands platform

Public API endpoints for scheduled command execution, storage, event subscription, activity tracking, and fetching an exchange token. All require X-API-KEY header. Many endpoints require an exchange token (from command context or POST /v1/auth/fetch-command-exchange-token/).

Endpoints summary

Scheduling

POST /v1/scheduler/

Schedules a command to run at a future time.

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

Response (201 Created):

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

GET /v1/scheduler/

Lists all scheduled command jobs for the organization.

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

DELETE /v1/scheduler/{id}/

Cancels a scheduled job.

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

Storage

POST /v1/storage/

Writes a key-value pair. Data is scoped to the user and organization.

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

GET /v1/storage/{key}/

Reads a key-value pair.

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

Response (200 OK):

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

DELETE /v1/storage/{key}/

Deletes a key-value pair.

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

Event subscription

POST /v1/events/subscribe/

Subscribes to an event type for the authenticated user.

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

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

Unsubscribes from an event.

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

Activity

POST /v1/activity/

Submits an activity entry linked to the authenticated user.

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

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

Fetches an exchange token that allows making API calls on behalf of a specific user. Requires your API key to have the necessary permissions.

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

Response (200 OK):

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

Exchange Token authentication is disabled by default. Contact support to enable it for your organization.