Users

ChronaPilot Connect managed end-users — preferences, lifecycle, and the canonical identity layer.

Endpoints

POST /v1/users Create a managed user idempotent

GET /v1/users/{id} Retrieve

PATCH /v1/users/{id} Update

POST /v1/users/{id}/deactivate Pause an account

POST /v1/users/{id}/reactivate Restore an account

DELETE /v1/users/{id} Hard delete

Object shape

A ChronaPilot Connect managed user.

Field	Type	Description
id	string	Prefixed usr_.
object	string	Always user.
email	string	Account email.
display_name	string?	User-visible name.
timezone	string?	IANA timezone (default UTC).
default_travel_mode	string	drive, walk, transit.
default_parking_buffer	integer	Default parking buffer minutes (default 5).
default_walk_buffer	integer	Default walk buffer minutes (default 3).
preferred_departure	string	on_time, 5_min_early, 10_min_early.
pre_alert_minutes	integer	Minutes before event for pre-alert (default 10).
alert_profile	string	minimal, balanced, detailed, quiet.
theme	string	system, light, dark.
sound_enabled	boolean	Alert sounds on/off.
haptic_enabled	boolean	Haptics on/off.
quiet_hours_start	string?	HH:mm in user's timezone.
quiet_hours_end	string?	HH:mm in user's timezone.
onboarding_completed	boolean	Set to true once you've finished bootstrapping.
deactivated_at	datetime?	If non-null, account is paused; API returns 403 account_deactivated.
created_at	datetime	Creation time.

Endpoints

HTTP
POST   /v1/users
GET    /v1/users/{id}
PATCH  /v1/users/{id}
POST   /v1/users/{id}/deactivate
POST   /v1/users/{id}/reactivate
DELETE /v1/users/{id}

Deactivation is reversible. Deletion is not — it cascades through events, connections, devices, and provider tokens, then fires user.deleted. The user's Entra ExternalID account is also deleted unless the user has accounts on other platforms in the same identity tenant.

Reference implementation

curl https://api.chronapilot.com/v1/users \ -X POST \ -H "Authorization: Bearer sk_test_4eC39HqLyjWDarjtT1zdp7dc" \ -H "Chronapilot-Version: 2026-05-20" \ -H "Content-Type: application/json" \ -d '{ "email": "alice@example.com", "display_name": "Alice Demo", "timezone": "America/Los_Angeles" }'

import ChronaPilot from '@chronapilot/node'; const cp = new ChronaPilot('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); const result = await cp.users.create({ email: 'alice@example.com', display_name: 'Alice Demo', timezone: 'America/Los_Angeles' });

import chronapilot chronapilot.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' result = chronapilot.User.create( email='alice@example.com', display_name='Alice Demo', timezone='America/Los_Angeles', )

{ "id": "usr_1abc2def3ghi", "object": "user", "email": "alice@example.com", "display_name": "Alice Demo", "timezone": "America/Los_Angeles", "default_travel_mode": "drive", "preferred_departure": "on_time", "alert_profile": "balanced", "theme": "system", "onboarding_completed": false, "deactivated_at": null, "created_at": "2026-05-20T18:14:22Z", "livemode": true, "request_id": "req_1A2b3C4d5E6f" }