Update User
Access: organization admins or users allowed by user policies. Cross-organization selectors are excluded from this public spec.
Invite, update, suspend, and inspect organization users.
POST
https://enterprise.spacemedia.uk
/
api
/
v1
/
users
/
{uuid}
Update User
curl --request POST \
--url https://enterprise.spacemedia.uk/api/v1/users/{uuid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form first_name=Maya \
--form last_name=Chen \
--form email=maya.chen@example.test \
--form roles=role-admin-demo \
--form language=English \
--form 'country=United Kingdom'const form = new FormData();
form.append('first_name', 'Maya');
form.append('last_name', 'Chen');
form.append('email', 'maya.chen@example.test');
form.append('roles', 'role-admin-demo');
form.append('language', 'English');
form.append('country', 'United Kingdom');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://enterprise.spacemedia.uk/api/v1/users/{uuid}', 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://enterprise.spacemedia.uk/api/v1/users/{uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_name\"\r\n\r\nMaya\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"last_name\"\r\n\r\nChen\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\nmaya.chen@example.test\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"roles\"\r\n\r\nrole-admin-demo\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"country\"\r\n\r\nUnited Kingdom\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/users/{uuid}"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_name\"\r\n\r\nMaya\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"last_name\"\r\n\r\nChen\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\nmaya.chen@example.test\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"roles\"\r\n\r\nrole-admin-demo\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"country\"\r\n\r\nUnited Kingdom\r\n-----011000010111000001101001--"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, headers=headers)
print(response.text){
"data": [
{
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Use application/json for API responses.
Bearer access token. Use Bearer <YOUR_ACCESS_TOKEN>.
Body
multipart/form-data
The body is of type object.
Response
Success
The response is of type object.
Previous
Suspend UserAccess: organization admins or users allowed by user policies. Cross-organization selectors are excluded from this public spec.
Invite, update, suspend, and inspect organization users.
Next
⌘I
Update User
curl --request POST \
--url https://enterprise.spacemedia.uk/api/v1/users/{uuid} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form first_name=Maya \
--form last_name=Chen \
--form email=maya.chen@example.test \
--form roles=role-admin-demo \
--form language=English \
--form 'country=United Kingdom'const form = new FormData();
form.append('first_name', 'Maya');
form.append('last_name', 'Chen');
form.append('email', 'maya.chen@example.test');
form.append('roles', 'role-admin-demo');
form.append('language', 'English');
form.append('country', 'United Kingdom');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://enterprise.spacemedia.uk/api/v1/users/{uuid}', 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://enterprise.spacemedia.uk/api/v1/users/{uuid}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_name\"\r\n\r\nMaya\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"last_name\"\r\n\r\nChen\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\nmaya.chen@example.test\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"roles\"\r\n\r\nrole-admin-demo\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"country\"\r\n\r\nUnited Kingdom\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: multipart/form-data"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/users/{uuid}"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"first_name\"\r\n\r\nMaya\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"last_name\"\r\n\r\nChen\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"email\"\r\n\r\nmaya.chen@example.test\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"roles\"\r\n\r\nrole-admin-demo\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"language\"\r\n\r\nEnglish\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"country\"\r\n\r\nUnited Kingdom\r\n-----011000010111000001101001--"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, headers=headers)
print(response.text){
"data": [
{
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}