Update user profile

Updates information in the profile of the currently logged in user. Note that all fields are optional, i.e., a partial view of the request body may be given.

PUT /me

Update user profile

cURL

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>",
  "settings_webapp": {
    "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
    },
    "timestamp_last_time_upgrade_app_shown": "2023-11-07T05:31:56Z"
  },
  "settings_nativeapp": {
    "theme": "<string>",
    "map_style": "<string>",
    "font_size": "<string>",
    "animations": true
  },
  "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>"
}
'

import requests

url = "https://ctechnology.io/api/v2.2/me"

payload = {
    "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>",
    "settings_webapp": {
        "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
        },
        "timestamp_last_time_upgrade_app_shown": "2023-11-07T05:31:56Z"
    },
    "settings_nativeapp": {
        "theme": "<string>",
        "map_style": "<string>",
        "font_size": "<string>",
        "animations": True
    },
    "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>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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>',
    settings_webapp: {
      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},
      timestamp_last_time_upgrade_app_shown: '2023-11-07T05:31:56Z'
    },
    settings_nativeapp: {
      theme: '<string>',
      map_style: '<string>',
      font_size: '<string>',
      animations: true
    },
    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>'
  })
};

fetch('https://ctechnology.io/api/v2.2/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ctechnology.io/api/v2.2/me",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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>',
    'settings_webapp' => [
        '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
        ],
        'timestamp_last_time_upgrade_app_shown' => '2023-11-07T05:31:56Z'
    ],
    'settings_nativeapp' => [
        'theme' => '<string>',
        'map_style' => '<string>',
        'font_size' => '<string>',
        'animations' => true
    ],
    '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>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ctechnology.io/api/v2.2/me"

	payload := strings.NewReader("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"may_use_email_for_marketing\": true,\n  \"address_country_code\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_city\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"profile_picture_id\": \"<string>\",\n  \"primary_locale\": \"<string>\",\n  \"settings_webapp\": {\n    \"current_organization\": \"<string>\",\n    \"selected_theme_id\": \"<string>\",\n    \"private_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"professional_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"timestamp_last_time_upgrade_app_shown\": \"2023-11-07T05:31:56Z\"\n  },\n  \"settings_nativeapp\": {\n    \"theme\": \"<string>\",\n    \"map_style\": \"<string>\",\n    \"font_size\": \"<string>\",\n    \"animations\": true\n  },\n  \"notification_new_message\": true,\n  \"notification_new_news_article\": true,\n  \"ecosystem_timestamp_last_news_read\": \"2023-11-07T05:31:56Z\",\n  \"company_name\": \"<string>\",\n  \"company_tel\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://ctechnology.io/api/v2.2/me")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"may_use_email_for_marketing\": true,\n  \"address_country_code\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_city\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"profile_picture_id\": \"<string>\",\n  \"primary_locale\": \"<string>\",\n  \"settings_webapp\": {\n    \"current_organization\": \"<string>\",\n    \"selected_theme_id\": \"<string>\",\n    \"private_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"professional_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"timestamp_last_time_upgrade_app_shown\": \"2023-11-07T05:31:56Z\"\n  },\n  \"settings_nativeapp\": {\n    \"theme\": \"<string>\",\n    \"map_style\": \"<string>\",\n    \"font_size\": \"<string>\",\n    \"animations\": true\n  },\n  \"notification_new_message\": true,\n  \"notification_new_news_article\": true,\n  \"ecosystem_timestamp_last_news_read\": \"2023-11-07T05:31:56Z\",\n  \"company_name\": \"<string>\",\n  \"company_tel\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ctechnology.io/api/v2.2/me")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"may_use_email_for_marketing\": true,\n  \"address_country_code\": \"<string>\",\n  \"address_street\": \"<string>\",\n  \"address_city\": \"<string>\",\n  \"address_zip\": \"<string>\",\n  \"profile_picture_id\": \"<string>\",\n  \"primary_locale\": \"<string>\",\n  \"settings_webapp\": {\n    \"current_organization\": \"<string>\",\n    \"selected_theme_id\": \"<string>\",\n    \"private_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"professional_sidebar_filter_vehicles\": {\n      \"show_own_vehicles\": true,\n      \"show_client_vehicles\": true\n    },\n    \"timestamp_last_time_upgrade_app_shown\": \"2023-11-07T05:31:56Z\"\n  },\n  \"settings_nativeapp\": {\n    \"theme\": \"<string>\",\n    \"map_style\": \"<string>\",\n    \"font_size\": \"<string>\",\n    \"animations\": true\n  },\n  \"notification_new_message\": true,\n  \"notification_new_news_article\": true,\n  \"ecosystem_timestamp_last_news_read\": \"2023-11-07T05:31:56Z\",\n  \"company_name\": \"<string>\",\n  \"company_tel\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "data": {
    "id": "<string>",
    "email": "[e-mail]",
    "first_name": "<string>",
    "last_name": "<string>",
    "address_country_code": "<string>",
    "address_street": "<string>",
    "address_city": "<string>",
    "address_zip": "<string>",
    "profile_picture_url": "<string>",
    "settings_webapp": {
      "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
      },
      "timestamp_last_time_upgrade_app_shown": "2023-11-07T05:31:56Z"
    },
    "settings_nativeapp": {
      "theme": "<string>",
      "map_style": "<string>",
      "font_size": "<string>",
      "animations": true
    },
    "may_use_email_for_marketing": true,
    "profile_picture_id": "<string>",
    "primary_locale": "<string>",
    "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>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

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).

Show child attributes

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).

Show child attributes

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

200

application/json

Successful update of this user's profile.

header · API Header Single · object · required

Default header sent along with single-resource responses.

Show child attributes

data · User Profile · object · required

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

Show child attributes