DailyBot API endpoints for creating, managing, and retrieving check-in configurations and responses.

Check-ins

Check-ins are the core of DailyBot's async communication. Use these endpoints to create, manage, and retrieve check-in configurations and their responses. A check-in collects structured answers from team members on a recurring schedule.

List Check-ins

GET /v1/checkins/

Lists all check-ins accessible to the API key owner.

Query Parameters

Name	Type	Required	Description
`include_summary`	boolean	Optional	Include summary data for the check-in.
`date`	string	Optional	Filter by date (YYYY-MM-DD format).

Request

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

Response 200 OK

json

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "ci-1234-5678-abcd",
      "name": "Daily Standup",
      "active": true,
      "anonymous": false,
      "frequency": "weekdays",
      "template_uuid": "tpl-abcd-1234",
      "created_at": "2025-01-15T10:00:00Z"
    }
  ]
}

Get Check-in

GET /v1/checkins/{checkin-uuid}/

Retrieves detailed information for a specific check-in including questions and scheduling.

Query Parameters

Name	Type	Required	Description
`include_summary`	boolean	Optional	Include summary data for the check-in.
`date`	string	Optional	Filter by date (YYYY-MM-DD format).

Request

curl -X GET "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/" \
  -H "X-API-KEY: your_api_key"

Response 200 OK

json

{
  "uuid": "ci-1234-5678-abcd",
  "name": "Daily Standup",
  "active": true,
  "anonymous": false,
  "frequency": "weekdays",
  "template_uuid": "tpl-abcd-1234",
  "questions": [
    "What did you accomplish yesterday?",
    "What are you working on today?",
    "Any blockers?"
  ],
  "reporting_channels": [],
  "created_at": "2025-01-15T10:00:00Z"
}

Create Check-in

POST /v1/checkins/

Creates a new check-in from a template.

Body Parameters

Name	Type	Required	Description
`name`	string	Required	Name of the check-in.
`template`	string	Required	UUID of the template to use.
`active`	boolean	Optional	Whether the check-in is active.
`anonymous`	boolean	Optional	Whether responses are anonymous.
`frequency`	string	Optional	Schedule frequency (e.g. "weekdays", "daily", "weekly").
`work_days`	array	Optional	Days when the check-in runs (0=Monday, 6=Sunday).
`reminder_enabled`	boolean	Optional	Enable automatic reminders.
`custom_intro_message`	string	Optional	Custom introduction message sent to participants.

Request

curl -X POST "https://api.dailybot.com/v1/checkins/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Weekly Retrospective",
    "template": "tpl-abcd-1234",
    "frequency": "weekly",
    "work_days": [4],
    "reminder_enabled": true
  }'

Response 201 Created

json

{
  "uuid": "ci-new-5678-efgh",
  "name": "Weekly Retrospective",
  "active": true,
  "anonymous": false,
  "frequency": "weekly",
  "template_uuid": "tpl-abcd-1234",
  "work_days": [
    4
  ],
  "reminder_enabled": true,
  "created_at": "2026-02-14T12:00:00Z"
}

Update Check-in

PATCH /v1/checkins/{checkin-uuid}/

Updates existing check-in configuration. Only provided fields are modified.

Body Parameters

Name	Type	Required	Description
`name`	string	Optional	Name of the check-in.
`template`	string	Optional	UUID of the template to use.
`active`	boolean	Optional	Whether the check-in is active.
`anonymous`	boolean	Optional	Whether responses are anonymous.
`frequency`	string	Optional	Schedule frequency (e.g. "weekdays", "daily", "weekly").
`work_days`	array	Optional	Days when the check-in runs (0=Monday, 6=Sunday).
`reminder_enabled`	boolean	Optional	Enable automatic reminders.
`custom_intro_message`	string	Optional	Custom introduction message sent to participants.

Request

curl -X PATCH "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Standup",
    "reminder_enabled": false
  }'

Response 200 OK

json

{
  "uuid": "ci-1234-5678-abcd",
  "name": "Updated Standup",
  "active": true,
  "reminder_enabled": false,
  "created_at": "2025-01-15T10:00:00Z"
}

Delete Check-in

DELETE /v1/checkins/{checkin-uuid}/

Permanently removes a check-in and all associated data.

Request

curl -X DELETE "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/" \
  -H "X-API-KEY: your_api_key"

Response 204 No Content

json

Irreversible Action

Deleting a check-in permanently removes all its responses and configuration. This action cannot be undone.

List Check-in Responses

GET /v1/checkins/{checkin-uuid}/responses/

Fetches all responses submitted for a particular check-in. Supports date range filtering and pagination.

Query Parameters

Name	Type	Required	Description
`date_start`	string	Optional	Start date filter (YYYY-MM-DD).
`date_end`	string	Optional	End date filter (YYYY-MM-DD).
`limit`	integer	Optional	Number of results to return.
`offset`	integer	Optional	Number of results to skip.

Request

curl -X GET "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/responses/?date_start=2026-02-01&date_end=2026-02-14" \
  -H "X-API-KEY: your_api_key"

Response 200 OK

json

{
  "count": 42,
  "next": null,
  "previous": null,
  "results": [
    {
      "user": {
        "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "full_name": "Jane Smith"
      },
      "answers": [
        {
          "question": "What did you accomplish yesterday?",
          "answer": "Completed the API integration"
        },
        {
          "question": "What are you working on today?",
          "answer": "Working on webhook handlers"
        },
        {
          "question": "Any blockers?",
          "answer": "No blockers"
        }
      ],
      "has_blocker": false,
      "submitted_at": "2026-02-14T09:15:00Z"
    }
  ]
}

Send Reminders

POST /v1/checkins/{checkin-uuid}/send-reminders/

Sends completion reminders to pending respondents for a specific check-in.

Body Parameters

Name	Type	Required	Description
`users_uuids`	array	Optional	Array of user UUIDs to remind.
`users_emails`	array	Optional	Array of user emails to remind.
`reminder_triggered_by_user`	string	Optional	UUID of the user triggering the reminder.
`is_reminder_triggered_by_me`	boolean	Optional	Set to true if triggered by the API key owner.
`date`	string	Optional	Date for the reminder (YYYY-MM-DD).

Request

curl -X POST "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/send-reminders/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "is_reminder_triggered_by_me": true,
    "date": "2026-02-14"
  }'

Response 200 OK

json

{
  "message": "Users notified successfully"
}

Fill Out Responses

POST /v1/checkins/{checkin-uuid}/responses/

Submit check-in responses on behalf of a user. Requires an exchange token for the target user.

Exchange Token Required

This endpoint requires an exchange token to submit responses on behalf of another user.

Request

curl -X POST "https://api.dailybot.com/v1/checkins/ci-1234-5678-abcd/responses/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "exchange_token": "ext-token-1234",
    "answers": [
      "Completed the API integration",
      "Working on webhook handlers",
      "No blockers"
    ]
  }'

Response 201 Created

json

{
  "submitted_at": "2026-02-14T09:15:00Z",
  "status": "completed"
}

Check-ins API - DailyBot Developers

Check-ins

List Check-ins

Query Parameters

Get Check-in

Query Parameters

Create Check-in

Body Parameters

Update Check-in

Body Parameters

Delete Check-in

List Check-in Responses

Query Parameters

Send Reminders

Body Parameters

Fill Out Responses