Account

Update the signed-in member's public profile

Changes display_name, bio and/or the photo through the existing profile writers. These values are shared across the user’s memberships. Membership identity fields remain unchanged. A name change is refused when any company the user belongs to locks shared name edits. An unchanged value is a no-op. Changed fields publish profiles.updated after commit, attributed to the company of the credential.

photo_upload_id takes the receipt of an image uploaded through POST /media/uploads (any membership may sign one) and sets the shared photo, which GET /me also returns as avatar_url. The receipt must be the member’s own, unused and an image whose stored file matches what was signed, and it can be claimed until one hour after the expires_at that POST /media/uploads returned. It is consumed once: a repeat, an unknown or another member’s receipt, one claimed after that hour and a non-image one return 422 and change nothing. The fields and the photo are written together or not at all, and a refused photo leaves the receipt unused. Every membership of the user sees the new photo.

At least one field is required. Unknown and read-only fields are refused with 422 before any changes are made. Other catalogue fields need separate storage/resource work. Only a writable credential can update; a member JWT, or a portal JWT minted read-only, returns 403. Returns the same profile shape as GET, without its cache policy.

PATCH

api

member

v2026-10

profile

Update the signed-in member's public profile

curl --request PATCH \
  --url https://api.fluid.app/api/member/v2026-10/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "Rae Kim",
  "bio": "Helping people build healthier habits.",
  "photo_upload_id": "0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f"
}
'

import requests

url = "https://api.fluid.app/api/member/v2026-10/profile"

payload = {
    "display_name": "Rae Kim",
    "bio": "Helping people build healthier habits.",
    "photo_upload_id": "0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    display_name: 'Rae Kim',
    bio: 'Helping people build healthier habits.',
    photo_upload_id: '0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f'
  })
};

fetch('https://api.fluid.app/api/member/v2026-10/profile', 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://api.fluid.app/api/member/v2026-10/profile",
  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([
    'display_name' => 'Rae Kim',
    'bio' => 'Helping people build healthier habits.',
    'photo_upload_id' => '0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.fluid.app/api/member/v2026-10/profile"

	payload := strings.NewReader("{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.fluid.app/api/member/v2026-10/profile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/member/v2026-10/profile")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}"

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

{
  "status": 123,
  "data": {
    "display_name": "Riley Kim",
    "bio": "Helping people build healthier habits.",
    "photo_url": "https://ik.imagekit.io/fluid/avatars/riley.png",
    "mysite_url": "https://primex.fluid.app/my/riley-kim",
    "socials": [
      {
        "platform": "x",
        "handle": "rae_kim",
        "url": "https://x.com/rae_kim",
        "verified": false
      }
    ]
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, an opaque member token, or a verified One Auth identity access token for a non-impersonated rep or shopper. The credential alone identifies the member and company.

Body

application/json

Fields to change; omitted values remain unchanged.

display_name

string

Shared public name, not the membership identity returned by /me. A single-word name retains the existing surname.

Minimum string length: 1

Pattern: \S

Example:

"Rae Kim"

bio

string | null

Public biography; null clears it.

Example:

"A new biography."

photo_upload_id

string<uuid>

The upload_id of an image uploaded through POST /media/uploads and stored. It becomes the shared public photo and is consumed. The same image is the avatar GET /me returns.

Example:

"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f"

Response

The updated public profile.

status

integer

required

data

object

required

Existing public profile fields. Name, biography and photo belong to the shared user; the site URL belongs to the current membership. Social accounts mirror GET /socials through the shared resolver and are read-only here. Uploads and catalogue fields without dedicated public-profile storage are not exposed in this slice.

Show child attributes

meta

object

required

Envelope metadata present on every response.

Show child attributes

Update the signed-in member's public profile

curl --request PATCH \
  --url https://api.fluid.app/api/member/v2026-10/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "Rae Kim",
  "bio": "Helping people build healthier habits.",
  "photo_upload_id": "0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f"
}
'

import requests

url = "https://api.fluid.app/api/member/v2026-10/profile"

payload = {
    "display_name": "Rae Kim",
    "bio": "Helping people build healthier habits.",
    "photo_upload_id": "0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    display_name: 'Rae Kim',
    bio: 'Helping people build healthier habits.',
    photo_upload_id: '0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f'
  })
};

fetch('https://api.fluid.app/api/member/v2026-10/profile', 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://api.fluid.app/api/member/v2026-10/profile",
  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([
    'display_name' => 'Rae Kim',
    'bio' => 'Helping people build healthier habits.',
    'photo_upload_id' => '0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.fluid.app/api/member/v2026-10/profile"

	payload := strings.NewReader("{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.fluid.app/api/member/v2026-10/profile")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/member/v2026-10/profile")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"display_name\": \"Rae Kim\",\n  \"bio\": \"Helping people build healthier habits.\",\n  \"photo_upload_id\": \"0199a3f2-5b0d-7c3a-8f09-2a1b0c9d8e7f\"\n}"

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

{
  "status": 123,
  "data": {
    "display_name": "Riley Kim",
    "bio": "Helping people build healthier habits.",
    "photo_url": "https://ik.imagekit.io/fluid/avatars/riley.png",
    "mysite_url": "https://primex.fluid.app/my/riley-kim",
    "socials": [
      {
        "platform": "x",
        "handle": "rae_kim",
        "url": "https://x.com/rae_kim",
        "verified": false
      }
    ]
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Member API

Member Sites APIs

Messaging

Cowork

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Update the signed-in member's public profile

Authorizations

Body

Response