Users

Upsert your user profile (call on first login)

May create a company if company/teamSize are provided. Phone is normalized to E.164 (national trunk 0 dropped) and silently dropped if unparsable — never blocks signup; an existing phone is never overwritten (PATCH changes it).

post/users/me

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/users/me
  • Auth: HTTP bearer

Request body

namestring required
companystring
phonestring
teamSize'solo' | 'under_10' | 'under_50' | 'under_150' | 'under_300' | 'over_300'
heardFrom'search' | 'ai_assistant' | 'social' | 'word_of_mouth' | 'event' | 'press' | 'ads' | 'other'

« How did you hear about us? » — stored on the company created by this call; ignored otherwise.

timezonestring

IANA timezone.

locale'fr' | 'en' | 'de' | 'es' | 'it' | 'pt-BR' | 'nl' | 'pl' | 'sv' | 'da' | 'tr' | 'ja' | 'ko'

UI locale at signup. Applied on insert only — never overwrites an existing value.

acceptTermstrue

Terms checkbox ticked on /signup. Server stamps termsAcceptedAt and the currently published terms version (termsVersionId) — first acceptance only, never overwritten.

Response

idstring uuid required
namestring required
emailstring email required
phonestring nullable

E.164.

companyIdstring uuid nullable
photostring nullable
timezonestring required

IANA timezone.

locale'fr' | 'en' | 'de' | 'es' | 'it' | 'pt-BR' | 'nl' | 'pl' | 'sv' | 'da' | 'tr' | 'ja' | 'ko' nullable

Preferred UI/email locale. NULL = no preference recorded yet.

bannedboolean

Not returned by GET /users/me (restricted profile).

onboardingEmailsSentstring[]
lastActiveAtstring date-time nullable
npsTriggeredAtstring date-time nullable
termsAcceptedAtstring date-time nullable

First terms acceptance (signup checkbox).

termsVersionIdstring uuid nullable

Published terms version in force at acceptance (legal_document_versions).

tourSeenAtstring date-time nullable

Guided tour finished or skipped. NULL = the web app opens it at next load (first login).

storeyToursSeenobject

Storey (dashboard | projects | floor | context) → when its guided tour was finished or skipped. A missing storey = its tour opens the first time the user reaches it.

createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.