v1

latestOpenAPI 3.1.0AGPL-3.0 license2026-07-1210336283.6 KB
Users

Update the current user

Update the current user for the authenticated team.

patch/users/me

Request body

fullNamestring

Full name of the user. Must be between 2 and 32 characters

emailstring email

Email address of the user

avatarUrlstring uri

URL to the user's avatar image. Must be hosted on midday.ai domain

localestring

User's preferred locale for internationalization (language and region)

weekStartsOnMondayboolean

Whether the user's calendar week starts on Monday (true) or Sunday (false)

timezonestring

User's timezone identifier in IANA Time Zone Database format

timezoneAutoSyncboolean

Whether to automatically sync timezone with browser timezone

timeFormatnumber

User's preferred time format: 12 for 12-hour format, 24 for 24-hour format

dateFormat'dd/MM/yyyy' | 'MM/dd/yyyy' | 'yyyy-MM-dd' | 'dd.MM.yyyy'

User's preferred date format. Available options: 'dd/MM/yyyy', 'MM/dd/yyyy', 'yyyy-MM-dd', 'dd.MM.yyyy'

Example request

{
  "fullName": "Jane Doe",
  "email": "jane.doe@acme.com",
  "avatarUrl": "https://cdn.midday.ai/avatars/jane-doe.jpg",
  "locale": "en-US",
  "weekStartsOnMonday": true,
  "timezone": "America/New_York",
  "timezoneAutoSync": true,
  "timeFormat": 24,
  "dateFormat": "yyyy-MM-dd"
}

Response

The updated user

idstring uuid required

Unique identifier of the user

fullNamestring required

Full name of the user

emailstring email required

Email address of the user

avatarUrlstring uri nullable required

URL to the user's avatar image

localestring nullable required

User's preferred locale for internationalization (language and region)

weekStartsOnMondayboolean nullable required

Whether the user's calendar week starts on Monday (true) or Sunday (false)

timezonestring nullable required

User's timezone identifier in IANA Time Zone Database format

timezoneAutoSyncboolean nullable required

Whether to automatically sync timezone with browser timezone

timeFormatnumber nullable required

User's preferred time format: 12 for 12-hour format, 24 for 24-hour format

dateFormat'dd/MM/yyyy' | 'MM/dd/yyyy' | 'yyyy-MM-dd' | 'dd.MM.yyyy' | 'null' nullable required

User's preferred date format. Available options: 'dd/MM/yyyy', 'MM/dd/yyyy', 'yyyy-MM-dd', 'dd.MM.yyyy'

fileKeystring nullable required

Team file key (JWT token) for proxy/download access to team files. This compact JWT token contains the team ID and is shared by all team members. Use this token as the fk query parameter when accessing file endpoints (proxy, download). The token is team-scoped and provides access to files belonging to the user's team. Returns null if the user has no team.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "fullName": "Jane Doe",
  "email": "jane.doe@acme.com",
  "avatarUrl": "https://cdn.midday.ai/avatars/jane-doe.jpg",
  "locale": "en-US",
  "weekStartsOnMonday": true,
  "timezone": "America/New_York",
  "timezoneAutoSync": true,
  "timeFormat": 24,
  "dateFormat": "yyyy-MM-dd",
  "fileKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZWFtSWQiOiIxMjM0NTY3OC05YWJjLWRlZmctMTIzNC01Njc4OTBhYmNkZWYifQ.signature",
  "team": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Acme Corporation",
    "logoUrl": "https://cdn.midday.ai/logos/acme-corp.png",
    "plan": "pro"
  }
}