Skip to main content
PUT
/
me
Update user profile
curl --request PUT \
  --url https://ctechnology.io/api/v2.2/me \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "may_use_email_for_marketing": true,
  "address_country_code": "<string>",
  "address_street": "<string>",
  "address_city": "<string>",
  "address_zip": "<string>",
  "profile_picture_id": "<string>",
  "primary_locale": "<string>",
  "measurement_units": "METRIC",
  "time_format": "24H",
  "settings_webapp": {
    "main_role": "PRIVATE",
    "current_organization": "<string>",
    "selected_theme_id": "<string>",
    "private_sidebar_filter_vehicles": {
      "show_own_vehicles": true,
      "show_client_vehicles": true
    },
    "professional_sidebar_filter_vehicles": {
      "show_own_vehicles": true,
      "show_client_vehicles": true
    },
    "scrollbar_style": "ON_SCRL",
    "timestamp_last_time_upgrade_app_shown": "2023-11-07T05:31:56Z"
  },
  "settings_nativeapp": {
    "theme": "<string>",
    "map_style": "<string>",
    "font_size": "<string>",
    "animations": true,
    "update_interval": "INSTANT"
  },
  "notification_new_message": true,
  "notification_new_news_article": true,
  "ecosystem_timestamp_last_news_read": "2023-11-07T05:31:56Z",
  "company_name": "<string>",
  "company_tel": "<string>"
}
'
{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "via": "me",
        "organization_id": "<string>"
      }
    ]
  },
  "data": {
    "id": "<string>",
    "email": "jsmith@example.com",
    "first_name": "<string>",
    "last_name": "<string>",
    "address_country_code": "<string>",
    "address_street": "<string>",
    "address_city": "<string>",
    "address_zip": "<string>",
    "profile_picture_url": "<string>",
    "measurement_units": "METRIC",
    "settings_webapp": {
      "main_role": "PRIVATE",
      "current_organization": "<string>",
      "selected_theme_id": "<string>",
      "private_sidebar_filter_vehicles": {
        "show_own_vehicles": true,
        "show_client_vehicles": true
      },
      "professional_sidebar_filter_vehicles": {
        "show_own_vehicles": true,
        "show_client_vehicles": true
      },
      "scrollbar_style": "ON_SCRL",
      "timestamp_last_time_upgrade_app_shown": "2023-11-07T05:31:56Z"
    },
    "settings_nativeapp": {
      "theme": "<string>",
      "map_style": "<string>",
      "font_size": "<string>",
      "animations": true,
      "update_interval": "INSTANT"
    },
    "may_use_email_for_marketing": true,
    "profile_picture_id": "<string>",
    "primary_locale": "<string>",
    "time_format": "24H",
    "notification_new_message": true,
    "notification_new_news_article": true,
    "ecosystem_timestamp_last_news_read": "2023-11-07T05:31:56Z",
    "company_name": "<string>",
    "company_tel": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Note that the API key has to be sent as Token 123 where 123 is the key you received after logging in or by creating on the developer dashboard.

Body

application/json

A user's profile, consisting of email, name, profile picture, etc.

​
first_name
string

The first name of this user.

​
last_name
string

The last name of this user.

​
may_use_email_for_marketing
boolean

If the user has agreed to receive marketing emails. This is a separate setting from the general notification settings, as it is not related to the app's functionality, but to privacy rights instead.

​
address_country_code
string

The country code of the country this user lives in.

​
address_street
string

The street address of this user.

​
address_city
string

The city this user lives in.

​
address_zip
string

The zip code of the city this user lives in.

​
profile_picture_id
string

The user's profile image unique identifier. You can retrieve a new image identifier by POSTing a new image to /image/. Please refer to the respective section of this documentation.

​
primary_locale
string

The primary locale (language) of a user. If it is not set, it is automatically set the next time the user logs in (to the default browser / OS language).

​
measurement_units
enum<string>

The chosen measurement units (metric or imperial). Note: This is only used for displaying values in frontends - everything served and consumed by the API is in metric units.

Available options:
METRIC,
IMPERIAL
​
time_format
enum<string>

The chosen time format, as 24-hour vs 12-hour with AM/PM. Note: This is only used for displaying values in frontends.

Available options:
24H,
AMPM
​
settings_webapp
Settings Webapp · object

User settings (for the c.technology webapp). You should likely not change these settings using the API, as it will have little effect on anything that you could use the API for (and the settings might frequently change when a user logs in).

​
settings_nativeapp
Settings Nativeapp · object

User settings (for the c.technology native apps). You should likely not change these settings using the API, as it will have little effect on anything that you could use the API for (and the settings might frequently change when a user logs in).

​
notification_new_message
boolean

If the user wants to receive notifications upon receiving a new message.

​
notification_new_news_article
boolean

If the user wants to receive notifications upon a partner posting a new news article.

​
ecosystem_timestamp_last_news_read
string<date-time>

The date/time at which the user saw the news last time. Used to determine which news are considered "new" for a user.

​
company_name
string

Deprecated: The company the user works at.

​
company_tel
string

Deprecated: The phone number of the company the user works at.

Response

Successful update of this user's profile.

​
header
API Header Single · object
required

Default header sent along with single-resource responses.

​
data
User Profile · object
required

A user's profile, consisting of email, name, profile picture, etc.