Update current user
curl --request PATCH \
--url https://beta.getsales.io/id/v1/api/users/current \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": true,
"onboarding_completed": true,
"onboarding_steps": [
"<string>"
],
"locale": "<string>"
}
}
'import requests
url = "https://beta.getsales.io/id/v1/api/users/current"
payload = {
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": True,
"onboarding_completed": True,
"onboarding_steps": ["<string>"],
"locale": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
first_name: '<string>',
last_name: '<string>',
avatar_url: '<string>',
phone: '<string>',
timezone: '<string>',
country: '<string>',
config: {
latest_team_sid: '<string>',
setup_completed: true,
onboarding_completed: true,
onboarding_steps: ['<string>'],
locale: '<string>'
}
})
};
fetch('https://beta.getsales.io/id/v1/api/users/current', 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://beta.getsales.io/id/v1/api/users/current",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => '<string>',
'last_name' => '<string>',
'avatar_url' => '<string>',
'phone' => '<string>',
'timezone' => '<string>',
'country' => '<string>',
'config' => [
'latest_team_sid' => '<string>',
'setup_completed' => true,
'onboarding_completed' => true,
'onboarding_steps' => [
'<string>'
],
'locale' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <api-key>"
],
]);
$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://beta.getsales.io/id/v1/api/users/current"
payload := strings.NewReader("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<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.patch("https://beta.getsales.io/id/v1/api/users/current")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/id/v1/api/users/current")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"default_team_sid": "<string>",
"email": "<string>",
"email_status": "unverified",
"auth_provider": "password",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": true,
"setup_step": "verify",
"setup_call_step": true,
"onboarding_completed": true,
"onboarding_steps": [
"<string>"
],
"locale": "<string>"
},
"utm": {},
"created_at": "<string>",
"updated_at": "<string>",
"erasure_requested_at": "<string>",
"erased_at": "<string>",
"deleted_at": "<string>"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<string>"
]
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}users
Update current user
Edit the signed-in account: first_name, last_name, avatar_url, phone, timezone, country and a shallow config patch (keys merge, the rest stays). Email, the default team and erasure keep their own /auth flows; sids are read-only. At least one field. An API key has no profile (403 not_a_user_actor). The avatar FILE goes through the app upload, not here: pass a URL, or null to remove it.
Contract:
- MCP tool
update_current_user, registry packagemcp.id/users, mountid.identity. - Operation
update, response envelopeupdate. - Flags: none.
PATCH
/
api
/
users
/
current
Update current user
curl --request PATCH \
--url https://beta.getsales.io/id/v1/api/users/current \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Team-SID: <api-key>' \
--data '
{
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": true,
"onboarding_completed": true,
"onboarding_steps": [
"<string>"
],
"locale": "<string>"
}
}
'import requests
url = "https://beta.getsales.io/id/v1/api/users/current"
payload = {
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": True,
"onboarding_completed": True,
"onboarding_steps": ["<string>"],
"locale": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Team-SID": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: 'Bearer <token>',
'Team-SID': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
first_name: '<string>',
last_name: '<string>',
avatar_url: '<string>',
phone: '<string>',
timezone: '<string>',
country: '<string>',
config: {
latest_team_sid: '<string>',
setup_completed: true,
onboarding_completed: true,
onboarding_steps: ['<string>'],
locale: '<string>'
}
})
};
fetch('https://beta.getsales.io/id/v1/api/users/current', 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://beta.getsales.io/id/v1/api/users/current",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'first_name' => '<string>',
'last_name' => '<string>',
'avatar_url' => '<string>',
'phone' => '<string>',
'timezone' => '<string>',
'country' => '<string>',
'config' => [
'latest_team_sid' => '<string>',
'setup_completed' => true,
'onboarding_completed' => true,
'onboarding_steps' => [
'<string>'
],
'locale' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Team-SID: <api-key>"
],
]);
$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://beta.getsales.io/id/v1/api/users/current"
payload := strings.NewReader("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Team-SID", "<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.patch("https://beta.getsales.io/id/v1/api/users/current")
.header("Authorization", "Bearer <token>")
.header("Team-SID", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://beta.getsales.io/id/v1/api/users/current")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Team-SID"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"avatar_url\": \"<string>\",\n \"phone\": \"<string>\",\n \"timezone\": \"<string>\",\n \"country\": \"<string>\",\n \"config\": {\n \"latest_team_sid\": \"<string>\",\n \"setup_completed\": true,\n \"onboarding_completed\": true,\n \"onboarding_steps\": [\n \"<string>\"\n ],\n \"locale\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"operation": "update",
"item": {
"sid": "<string>",
"default_team_sid": "<string>",
"email": "<string>",
"email_status": "unverified",
"auth_provider": "password",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>",
"phone": "<string>",
"timezone": "<string>",
"country": "<string>",
"config": {
"latest_team_sid": "<string>",
"setup_completed": true,
"setup_step": "verify",
"setup_call_step": true,
"onboarding_completed": true,
"onboarding_steps": [
"<string>"
],
"locale": "<string>"
},
"utm": {},
"created_at": "<string>",
"updated_at": "<string>",
"erasure_requested_at": "<string>",
"erased_at": "<string>",
"deleted_at": "<string>"
},
"updated_fields": [
"<string>"
],
"previous_values": {},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
},
"kept_fields": [
"<string>"
]
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}{
"success": false,
"error": {
"code": "validation_failed",
"message": "<string>",
"recoverable": true,
"suggestion": "<string>",
"field_errors": {},
"blockers": [
{
"type": "<string>",
"severity": "hard",
"description": "<string>",
"entity_sid": "<string>",
"resolution": "<string>",
"resolution_hint": "<string>",
"count": 123
}
],
"context": {}
},
"meta": {
"trace_id": "<string>",
"span_id": "<string>",
"timestamp": "<string>",
"duration_ms": 1,
"team_sid": "<string>",
"actor_type": "<string>"
}
}Authorizations
Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.
Team scope for tokens that do not carry one. Ignored when the token already names a team.
Body
application/json
Request body of update_current_user.
Given name, 1..120 chars.
Required string length:
1 - 120Family name, up to 120 chars; null clears it.
Maximum string length:
120An absolute URL of the picture, up to 2048 chars; null removes the avatar.
Maximum string length:
2048Up to 40 chars; null clears it.
Maximum string length:
40IANA zone, e.g. Europe/Riga; null clears it.
Maximum string length:
64ISO 3166-1 alpha-2; null clears it.
Required string length:
2A shallow patch of the preferences: the keys sent are merged over the stored ones.
Show child attributes
Show child attributes
Response
update success envelope.
Available options:
true Available options:
update Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.