curl --request PATCH \
--url https://app.orgo.space/api/v1/users/{id}/new-email \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '{}'import requests
url = "https://app.orgo.space/api/v1/users/{id}/new-email"
payload = {}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({})
};
fetch('https://app.orgo.space/api/v1/users/{id}/new-email', 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://app.orgo.space/api/v1/users/{id}/new-email",
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([
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+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://app.orgo.space/api/v1/users/{id}/new-email"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+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://app.orgo.space/api/v1/users/{id}/new-email")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/users/{id}/new-email")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"newEmailRequested": "michael.chen@example.com",
"isGuest": true,
"resignPending": 42,
"resignApproved": 42,
"dateBirth": "2026-01-15T10:30:00+00:00",
"age": 34,
"fullName": "James Patterson",
"accountType": "string",
"parentConsentDate": "2026-01-15T10:30:00+00:00",
"parentConsentMethod": "string",
"roles": [
"string"
],
"customFieldValues": [
{
"id": 42,
"field": {
"name": "Boston Chapter",
"isOnlyAdmin": true,
"visibility": "string"
},
"value": "Vegetarian",
"media": {
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
}
],
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"phoneNumber": "+1 415 555 0142",
"isFollowGeneralUnit": true,
"roleGroups": [
"string"
],
"isSupporter": true,
"identity": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"status": "ACTIVE",
"addressDetails": "123 Beacon Street, Boston, MA 02108"
},
"adhesion": {
"id": 42,
"status": "ACTIVE",
"medias": [
{
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
]
},
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"postalCode": "02108",
"address": "123 Beacon Street",
"phoneLocalNumber": "+1 415 555 0142",
"pushNotificationTokens": [
{
"id": 42,
"mobileOneSignalSubscriptionId": "+14155550142",
"deviceId": "string",
"deviceType": "string"
}
],
"permissions": [
"string"
],
"customPermissions": [
"string"
],
"privacy": {
"id": 42,
"createdAt": "2026-01-15T10:30:00+00:00",
"updatedAt": "2026-01-15T10:30:00+00:00",
"age": true,
"name": true,
"email": true,
"phone": true,
"social": true,
"image": true,
"town": true,
"profession": true,
"profile": true,
"hasSeenProfileCompletionCelebration": true
},
"notificationSettings": [
"string"
],
"isSubscribedNewsletter": true,
"isSubscribedPush": true,
"isSubscribedDiscussion": 42,
"isSubscribedEvent": true,
"isSubscribedComment": true,
"isSubscribedIssue": true,
"isSubscribedVote": true,
"isSubscribedTag": true,
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345",
"mfaEnabled": true
}Change user email
Initiates an email change for a user. Admins (ADMIN_LOCAL or HR_TENANT) can change the email immediately; non-admin users trigger a confirmation email to the current address. Validates that the new email is not already registered. The change is logged for audit purposes. Accessible by the user themselves, local admins, or parent-level admins.
curl --request PATCH \
--url https://app.orgo.space/api/v1/users/{id}/new-email \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/merge-patch+json' \
--data '{}'import requests
url = "https://app.orgo.space/api/v1/users/{id}/new-email"
payload = {}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/merge-patch+json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/merge-patch+json'},
body: JSON.stringify({})
};
fetch('https://app.orgo.space/api/v1/users/{id}/new-email', 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://app.orgo.space/api/v1/users/{id}/new-email",
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([
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/merge-patch+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://app.orgo.space/api/v1/users/{id}/new-email"
payload := strings.NewReader("{}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/merge-patch+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://app.orgo.space/api/v1/users/{id}/new-email")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/merge-patch+json")
.body("{}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/users/{id}/new-email")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/merge-patch+json'
request.body = "{}"
response = http.request(request)
puts response.read_body{
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"newEmailRequested": "michael.chen@example.com",
"isGuest": true,
"resignPending": 42,
"resignApproved": 42,
"dateBirth": "2026-01-15T10:30:00+00:00",
"age": 34,
"fullName": "James Patterson",
"accountType": "string",
"parentConsentDate": "2026-01-15T10:30:00+00:00",
"parentConsentMethod": "string",
"roles": [
"string"
],
"customFieldValues": [
{
"id": 42,
"field": {
"name": "Boston Chapter",
"isOnlyAdmin": true,
"visibility": "string"
},
"value": "Vegetarian",
"media": {
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
}
],
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"phoneNumber": "+1 415 555 0142",
"isFollowGeneralUnit": true,
"roleGroups": [
"string"
],
"isSupporter": true,
"identity": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"status": "ACTIVE",
"addressDetails": "123 Beacon Street, Boston, MA 02108"
},
"adhesion": {
"id": 42,
"status": "ACTIVE",
"medias": [
{
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
]
},
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"postalCode": "02108",
"address": "123 Beacon Street",
"phoneLocalNumber": "+1 415 555 0142",
"pushNotificationTokens": [
{
"id": 42,
"mobileOneSignalSubscriptionId": "+14155550142",
"deviceId": "string",
"deviceType": "string"
}
],
"permissions": [
"string"
],
"customPermissions": [
"string"
],
"privacy": {
"id": 42,
"createdAt": "2026-01-15T10:30:00+00:00",
"updatedAt": "2026-01-15T10:30:00+00:00",
"age": true,
"name": true,
"email": true,
"phone": true,
"social": true,
"image": true,
"town": true,
"profession": true,
"profile": true,
"hasSeenProfileCompletionCelebration": true
},
"notificationSettings": [
"string"
],
"isSubscribedNewsletter": true,
"isSubscribedPush": true,
"isSubscribedDiscussion": 42,
"isSubscribedEvent": true,
"isSubscribedComment": true,
"isSubscribedIssue": true,
"isSubscribedVote": true,
"isSubscribedTag": true,
"professionOrganisation": "Civic Collective",
"professionOrganisationWebsite": "https://civic-collective.example.com",
"professionOrganisationRole": "Civic Collective",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345",
"mfaEnabled": true
}Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Path Parameters
User identifier
Body
The updated User resource
The body is of type object.
Response
User resource updated
255255Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

