Skip to content

Update a checklist item

PUT
/api/v1/onboarding/checklist
curl --request PUT \
--url https://api.ultimateteam.ai/api/v1/onboarding/checklist \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <X-API-Key>' \
--data '{ "completed": true, "item_id": "example" }'

Mark a specific checklist item as completed or uncompleted. Validates item_id against the 9 valid item identifiers.

Media typeapplication/json
ChecklistItemUpdate

Request body for PUT /api/v1/onboarding/checklist.

Attributes: item_id: One of the 9 valid checklist item identifiers. completed: Whether the item should be marked complete.

object
completed
required
Completed

Whether the item is completed

boolean
item_id
required
Item Id

One of the 9 valid checklist item IDs

string
Examplegenerated
{
"completed": true,
"item_id": "example"
}

Successful Response

Media typeapplication/json
ChecklistProgressResponse

Response for GET/PUT /api/v1/onboarding/checklist.

Contains the completion status for all 9 checklist items plus computed aggregate fields.

Attributes: setup_profile: Whether user completed their profile. setup_business_info: Whether user added business info. setup_first_integration: Whether user connected first integration. activate_read_brief: Whether user read first morning brief. activate_chat_agent: Whether user chatted with an agent. activate_review_decision: Whether user reviewed a decision. optimize_custom_kpi: Whether user created a custom KPI. optimize_second_integration: Whether user connected second integration. optimize_invite_team: Whether user invited a team member. all_complete: True when all 9 items are completed. completed_count: Number of completed items (0-9). total_count: Total number of items (always 9).

object
activate_chat_agent
Activate Chat Agent
boolean
activate_read_brief
Activate Read Brief
boolean
activate_review_decision
Activate Review Decision
boolean
all_complete
All Complete
boolean
completed_count
Completed Count
integer
0 <= 9
optimize_custom_kpi
Optimize Custom Kpi
boolean
optimize_invite_team
Optimize Invite Team
boolean
optimize_second_integration
Optimize Second Integration
boolean
setup_business_info
Setup Business Info
boolean
setup_first_integration
Setup First Integration
boolean
setup_profile
Setup Profile
boolean
total_count
Total Count
integer
default: 9
Example
{
"activate_chat_agent": false,
"activate_read_brief": false,
"activate_review_decision": false,
"all_complete": false,
"completed_count": 0,
"optimize_custom_kpi": false,
"optimize_invite_team": false,
"optimize_second_integration": false,
"setup_business_info": false,
"setup_first_integration": false,
"setup_profile": false,
"total_count": 9
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}