Check-ins · API Reference · Developers
Create, configure, and archive check-ins with schedule, participants, and questions; list and manage responses. Prefer GET `/v1/checkins/{uuid}/detail/` for full authoring config.
Create, configure, and archive check-ins with schedule, participants, and questions; list and manage responses. Prefer GET `/v1/checkins/{uuid}/detail/` for full authoring config.
List check-ins
List check-ins
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | Optional | Page number (1-indexed). Default: 1. |
| page_size | integer | Optional | Items per page. Default: 50, max: 200. Alias: limit. |
| search | string | Optional | Case-insensitive substring search on check-in name. Max 256 chars. |
| date | string (YYYY-MM-DD) | Optional | Date for context. When provided, used for summary and pending users context. |
| team_uuid | string (uuid) | Optional | Filter to check-ins belonging to a specific team. |
| user_uuid | string (uuid) | Optional | Filter to check-ins associated with a specific user. |
| include_summary | boolean | Optional | Include AI-generated summary in the response. |
| include_pending_users | boolean | Optional | Include list of users who have not yet responded. |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
curl -sS -X GET 'https://api.dailybot.com/v1/checkins/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Create a check-in with schedule and questions
Creates a check-in with schedule, questions, and participants (≥1 user or team required). Admin/manager only.
Request body
{
"name": "string (required)",
"questions": "array (required)",
"participants": "object (required)",
"schedule": "object?",
"report_channels": "string[]?"
}Response
{
"id": "uuid",
"name": "string",
"schedule": "object",
"questions": "array",
"participants": "object"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | questions_required, checkin_requires_participant, unknown_field |
curl -sS -X POST 'https://api.dailybot.com/v1/checkins/create/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json' -d '{"name":"Daily Standup","questions":[{"type":"text","label":"Yesterday?","short_question":"Yesterday"}],"participants":{"user_uuids":["<uuid>"]}}'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
- is_anonymous is irreversible once enabled (400 anonymous_irreversible).
Retrieve a check-in
Retrieve a check-in
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
curl -sS -X GET 'https://api.dailybot.com/v1/checkins/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Check-in detail (canonical, full config)
Returns full check-in metadata: schedule, questions, participants, report channels, and all configuration fields. Prefer over GET /v1/checkins/{uuid}/ for authoring.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Response
{
"id": "uuid",
"schedule": "object",
"questions": "array",
"participants": "object",
"report_channels": "array"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 404 | checkin_not_found |
curl -sS -X GET 'https://api.dailybot.com/v1/checkins/{uuid}/detail/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
- CLI: dailybot checkin show <uuid>
Update check-in configuration
Partial update. participants fully replaces current set when included. Unknown fields return 400 unknown_field.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Request body
{
"name": "string?",
"schedule": "object?",
"participants": "object?",
"privacy": "string?",
"reminders_max_count": "integer?"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | unknown_field, anonymous_irreversible, intelligence_requires_smart_checkin |
curl -sS -X PATCH 'https://api.dailybot.com/v1/checkins/{uuid}/config/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json' -d '{"privacy":"everyone"}'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Archive (deactivate) a check-in
Sets check-in inactive and archived. Idempotent.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 404 | checkin_not_found |
curl -sS -X DELETE 'https://api.dailybot.com/v1/checkins/{uuid}/archive/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
add check-in question
Shared question management — same schema as forms. Supports logic, variations, is_blocker.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Request body
{
"type": "string",
"label": "string",
"short_question": "string"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | Validation errors — see errors reference |
curl -sS -X POST 'https://api.dailybot.com/v1/checkins/{uuid}/questions/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
patch check-in question
Shared question management — same schema as forms. Supports logic, variations, is_blocker.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| q_uuid | string (uuid) | Required | — |
Request body
{
"type": "string",
"label": "string",
"short_question": "string"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | Validation errors — see errors reference |
curl -sS -X PATCH 'https://api.dailybot.com/v1/checkins/{uuid}/questions/{q_uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
delete check-in question
Shared question management — same schema as forms. Supports logic, variations, is_blocker.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
| q_uuid | string (uuid) | Required | — |
Request body
{
"type": "string",
"label": "string",
"short_question": "string"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | Validation errors — see errors reference |
curl -sS -X DELETE 'https://api.dailybot.com/v1/checkins/{uuid}/questions/{q_uuid}/delete/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
List check-in responses (all participants by default)
Paginated list of check-in responses for all participants within a date range. Admin/manager callers may filter with ?user=<uuid>. Member callers only see their own responses. The ?all=true parameter applies to form responses only, not check-ins.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| start_date | string (YYYY-MM-DD) | Optional | Inclusive start date (caller's timezone). Also accepted: date_start, date_from. Default: today. |
| end_date | string (YYYY-MM-DD) | Optional | Inclusive end date, 23:59:59 in caller's timezone. Also accepted: date_end, date_to. Default: today. |
| search | string | Optional | Case-insensitive substring search on response content. Max 256 chars. |
| user | string (uuid) | Optional | Admin/manager: filter responses to a specific user. Must be a valid UUID (returns 400 invalid_user_identifier otherwise). Member callers are restricted to their own responses regardless of this parameter. |
| page | integer | Optional | Page number (1-indexed). Default: 1. |
| page_size | integer | Optional | Items per page. Default: 50, max: 200. Alias: limit. |
Errors
| Status | When |
|---|---|
| 400 | Validation error (invalid_user_identifier, invalid_date_range, search_query_too_long) |
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
curl -sS -X GET 'https://api.dailybot.com/v1/checkins/{uuid}/responses/?date_start=2026-06-30&date_end=2026-07-07' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
- Returns all participants' responses by default. Do not use ?all=true on this endpoint — that parameter is for form responses only.
reorder check-in question
Shared question management — same schema as forms. Supports logic, variations, is_blocker.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Request body
{
"question_uuids": "uuid[]"
}Errors
| Status | When |
|---|---|
| 401 | Missing or invalid credential |
| 403 | Insufficient permissions (admin/manager required for write) |
| 429 | Rate limited — Retry-After header set |
| 400 | Validation errors — see errors reference |
curl -sS -X PUT 'https://api.dailybot.com/v1/checkins/{uuid}/questions/reorder/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Create a check-in response
Create a check-in response
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
curl -sS -X POST 'https://api.dailybot.com/v1/checkins/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Replace a check-in response
Replace a check-in response
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
curl -sS -X PUT 'https://api.dailybot.com/v1/checkins/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Partially update a check-in response
Partially update a check-in response
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuid | string (uuid) | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
curl -sS -X PATCH 'https://api.dailybot.com/v1/checkins/{uuid}/responses/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
List follow-ups (DEPRECATED)
Deprecated alias retained for backwards compatibility. Prefer /v1/checkins/.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| include_archived | boolean | Optional | When true, include archived follow-ups/check-ins. |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
curl -sS -X GET 'https://api.dailybot.com/v1/followups/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
- Deprecated - use /v1/checkins/ instead.