Skip to content

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.

GET/v1/checkins/API keyCLI AuthOAuth 2.0Page-number pagination

List check-ins

List check-ins

Query parameters

NameTypeRequiredDescription
pageintegerOptionalPage number (1-indexed). Default: 1.
page_sizeintegerOptionalItems per page. Default: 50, max: 200. Alias: limit.
searchstringOptionalCase-insensitive substring search on check-in name. Max 256 chars.
datestring (YYYY-MM-DD)OptionalDate for context. When provided, used for summary and pending users context.
team_uuidstring (uuid)OptionalFilter to check-ins belonging to a specific team.
user_uuidstring (uuid)OptionalFilter to check-ins associated with a specific user.
include_summarybooleanOptionalInclude AI-generated summary in the response.
include_pending_usersbooleanOptionalInclude list of users who have not yet responded.

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - 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.

POST/v1/checkins/create/API keyCLI Auth

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

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400questions_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).
GET/v1/checkins/{uuid}/API keyCLI AuthOAuth 2.0

Retrieve a check-in

Retrieve a check-in

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not 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.

GET/v1/checkins/{uuid}/detail/API keyCLI Auth

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

NameTypeRequiredDescription
uuidstring (uuid)Required

Response

{
  "id": "uuid",
  "schedule": "object",
  "questions": "array",
  "participants": "object",
  "report_channels": "array"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
404checkin_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>
PATCH/v1/checkins/{uuid}/config/API keyCLI Auth

Update check-in configuration

Partial update. participants fully replaces current set when included. Unknown fields return 400 unknown_field.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Request body

{
  "name": "string?",
  "schedule": "object?",
  "participants": "object?",
  "privacy": "string?",
  "reminders_max_count": "integer?"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400unknown_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.

DELETE/v1/checkins/{uuid}/archive/API keyCLI Auth

Archive (deactivate) a check-in

Sets check-in inactive and archived. Idempotent.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
404checkin_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.

POST/v1/checkins/{uuid}/questions/API keyCLI Auth

add check-in question

Shared question management — same schema as forms. Supports logic, variations, is_blocker.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Request body

{
  "type": "string",
  "label": "string",
  "short_question": "string"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400Validation 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/v1/checkins/{uuid}/questions/{q_uuid}/API keyCLI Auth

patch check-in question

Shared question management — same schema as forms. Supports logic, variations, is_blocker.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required
q_uuidstring (uuid)Required

Request body

{
  "type": "string",
  "label": "string",
  "short_question": "string"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400Validation 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/v1/checkins/{uuid}/questions/{q_uuid}/delete/API keyCLI Auth

delete check-in question

Shared question management — same schema as forms. Supports logic, variations, is_blocker.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required
q_uuidstring (uuid)Required

Request body

{
  "type": "string",
  "label": "string",
  "short_question": "string"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400Validation 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.

GET/v1/checkins/{uuid}/responses/API keyCLI AuthPage-number pagination

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

NameTypeRequiredDescription
uuidstring (uuid)Required

Query parameters

NameTypeRequiredDescription
start_datestring (YYYY-MM-DD)OptionalInclusive start date (caller's timezone). Also accepted: date_start, date_from. Default: today.
end_datestring (YYYY-MM-DD)OptionalInclusive end date, 23:59:59 in caller's timezone. Also accepted: date_end, date_to. Default: today.
searchstringOptionalCase-insensitive substring search on response content. Max 256 chars.
userstring (uuid)OptionalAdmin/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.
pageintegerOptionalPage number (1-indexed). Default: 1.
page_sizeintegerOptionalItems per page. Default: 50, max: 200. Alias: limit.

Errors

StatusWhen
400Validation error (invalid_user_identifier, invalid_date_range, search_query_too_long)
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - 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.
PUT/v1/checkins/{uuid}/questions/reorder/API keyCLI Auth

reorder check-in question

Shared question management — same schema as forms. Supports logic, variations, is_blocker.

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Request body

{
  "question_uuids": "uuid[]"
}

Errors

StatusWhen
401Missing or invalid credential
403Insufficient permissions (admin/manager required for write)
429Rate limited — Retry-After header set
400Validation 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.

POST/v1/checkins/{uuid}/responses/API keyCLI AuthOAuth 2.0

Create a check-in response

Create a check-in response

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not 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.

PUT/v1/checkins/{uuid}/responses/API keyCLI AuthOAuth 2.0

Replace a check-in response

Replace a check-in response

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not 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.

PATCH/v1/checkins/{uuid}/responses/API keyCLI AuthOAuth 2.0

Partially update a check-in response

Partially update a check-in response

Path parameters

NameTypeRequiredDescription
uuidstring (uuid)Required

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not 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.

GET/v1/followups/API keyCLI Auth

List follow-ups (DEPRECATED)

Deprecated alias retained for backwards compatibility. Prefer /v1/checkins/.

Query parameters

NameTypeRequiredDescription
include_archivedbooleanOptionalWhen true, include archived follow-ups/check-ins.

Errors

StatusWhen
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - 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.