Florality

PATCH

/api/v1/members/{memberId}

members: read_write1,000 requests/minute/key · all plans

Active API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.

Ownership

A member belonging to another account is not accessible through this route. Missing or inaccessible members return 404.

Parameters

Path parameters

Name	Type	Required	Description
`memberId`	`string (uuid)`	Required	Identifier of the member.

Request body

application/json · required

Unknown properties are rejected.

Name	Type	Required	Description
`name`	`string`	Optional	Name of the resource.
`displayName`	`string \| null`	Optional	Display name.
`pronouns`	`string \| null`	Optional	Member pronouns.
`avatar`	`string \| null`	Optional	Avatar storage reference.
`background`	`string \| null`	Optional	Background storage reference.
`about`	`string \| null`	Optional	Member profile text.
`aboutTags`	`array<string> \| null`	Optional	Tags attached to the profile text. At most 20 items.
`profileStyle`	`object \| null`	Optional	Profile presentation settings.
`profileStyle.avatarRing`	`object`	Optional	Avatar Ring. Unknown properties are rejected.
`profileStyle.avatarRing.show`	`boolean`	Optional	Show.
`profileStyle.avatarRing.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.avatarRing.shape`	`string`	Optional	Shape. Allowed values: "circle", "square", "hexagon", "octagon", "star", "pentagon", "heart", "shield", "sakura", "neko", "butterfly", "sparkle", "crown", "moon".
`profileStyle.avatarRing.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.avatarRing.animation`	`string`	Optional	Animation. Allowed values: "none", "pulse", "rotate", "shimmer".
`profileStyle.avatarRing.animationSpeed`	`integer`	Optional	Animation Speed. Minimum: 1. Maximum: 5.
`profileStyle.avatarRing.strokeStyle`	`string`	Optional	Stroke Style. Allowed values: "single", "double", "glow".
`profileStyle.avatarRing.customMaskStorageId`	`string (uuid)`	Optional	Custom Mask Storage Id.
`profileStyle.avatarRing.customMaskPathD`	`string`	Optional	Custom Mask Path D. Minimum length: 1. Maximum length: 32768.
`profileStyle.bannerFrame`	`object`	Optional	Banner Frame. Unknown properties are rejected.
`profileStyle.bannerFrame.showBorder`	`boolean`	Optional	Show Border.
`profileStyle.bannerFrame.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.bannerFrame.borderWidthPx`	`integer`	Optional	Border Width Px. Minimum: 1. Maximum: 8.
`profileStyle.bannerFrame.borderStyle`	`string`	Optional	Border Style. Allowed values: "none", "solid", "dashed", "double".
`profileStyle.bannerFrame.cornerStyle`	`string`	Optional	Corner Style. Allowed values: "default", "rounded", "sharp".
`profileStyle.memberName`	`object`	Optional	Member Name. Unknown properties are rejected.
`profileStyle.memberName.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.memberName.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.memberName.letterSpacing`	`string`	Optional	Letter Spacing. Allowed values: "normal", "wide".
`profileStyle.memberName.fontFamily`	`null \| string`	Optional	Font Family.
`profileStyle.memberName.customFontId`	`null \| string (uuid)`	Optional	Custom Font Id.
`profileStyle.memberName.smallCaps`	`boolean`	Optional	Small Caps.
`profileStyle.memberName.textShadow`	`boolean`	Optional	Text Shadow.
`profileStyle.memberName.nameEffect`	`string`	Optional	Name Effect. Allowed values: "none", "shimmer", "soft-glow".
`profileStyle.bannerImage`	`object`	Optional	Banner Image. Unknown properties are rejected.
`profileStyle.bannerImage.brightness`	`number`	Optional	Brightness. Minimum: 0.5. Maximum: 1.5.
`profileStyle.bannerImage.contrast`	`number`	Optional	Contrast. Minimum: 0.5. Maximum: 1.5.
`profileStyle.bannerImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.bannerImage.tintOpacity`	`number`	Optional	Tint Opacity. Minimum: 0. Maximum: 0.5.
`profileStyle.avatarImage`	`object`	Optional	Avatar Image. Unknown properties are rejected.
`profileStyle.avatarImage.brightness`	`number`	Optional	Brightness. Minimum: 0.5. Maximum: 1.5.
`profileStyle.avatarImage.contrast`	`number`	Optional	Contrast. Minimum: 0.5. Maximum: 1.5.
`profileStyle.avatarImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.avatarImage.tintOpacity`	`number`	Optional	Tint Opacity. Minimum: 0. Maximum: 0.5.
`profileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`profileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "none", "dots", "grid", "noise".
`profileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`profileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`profileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill. Unknown properties are rejected.
`profileStyle.profileBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.profileBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.profileBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Unknown properties are rejected.
`profileStyle.pageBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.pageBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.pageBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Unknown properties are rejected.
`profileStyle.panelBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.panelBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex.
`profileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex.
`createdAt`	`integer \| null`	Optional	Creation time.
`clientMutationId`	`string (uuid)`	Optional	Client Mutation Id.
`moveToSystemScope`	`object`	Optional	Move To System Scope.
`moveToSystemScope.sideSystemId`	`string (uuid)`	Required	Side System Id.
`moveToSystemScope.subSystemId`	`string (uuid) \| null`	Optional	Sub System Id.

Response schema

200

Successful response.

Name	Type	Required	Description
`_id`	`string`	Required	Unique identifier.
`userId`	`string`	Required	Owning account identifier.
`directoryId`	`string`	Required	Containing folder identifier.
`sideSystemId`	`string`	Optional	Side System Id.
`subSystemId`	`string`	Optional	Sub System Id.
`name`	`string`	Required	Name of the resource.
`displayName`	`string`	Optional	Display name.
`pronouns`	`string`	Optional	Member pronouns.
`avatar`	`string`	Optional	Avatar storage reference.
`about`	`string`	Optional	Member profile text.
`aboutTags`	`array<string>`	Required	Tags attached to the profile text. Labels shown on the member About card (same semantics as custom-field tags).
`background`	`string`	Optional	Background storage reference.
`archivedAt`	`number`	Optional	Archiving time; null when active.
`createdAt`	`number`	Optional	Creation time.
`updatedAt`	`number`	Optional	Most recent update time.
`deletedAt`	`number`	Optional	Deletion time; null when active.
`purgeAt`	`number`	Optional	Purge At.
`originalDirectoryId`	`string`	Optional	Original Directory Id.
`profileStyle`	`null \| object`	Required	Profile presentation settings.
`profileStyle.avatarRing`	`object`	Optional	Avatar Ring.
`profileStyle.avatarRing.show`	`boolean`	Optional	Show. Allowed values: false, true.
`profileStyle.avatarRing.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.avatarRing.shape`	`string`	Optional	Shape. Allowed values: "moon", "circle", "square", "hexagon", "octagon", "star", "pentagon", "heart", "shield", "sakura", "neko", "butterfly", "sparkle", "crown".
`profileStyle.avatarRing.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.avatarRing.animation`	`string`	Optional	Animation. Allowed values: "none", "pulse", "rotate", "shimmer".
`profileStyle.avatarRing.animationSpeed`	`number`	Optional	Animation Speed.
`profileStyle.avatarRing.strokeStyle`	`string`	Optional	Stroke Style. Allowed values: "single", "double", "glow".
`profileStyle.avatarRing.customMaskStorageId`	`string`	Optional	Custom Mask Storage Id.
`profileStyle.avatarRing.customMaskPathD`	`string`	Optional	Custom Mask Path D.
`profileStyle.bannerFrame`	`object`	Optional	Banner Frame.
`profileStyle.bannerFrame.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.bannerFrame.showBorder`	`boolean`	Optional	Show Border. Allowed values: false, true.
`profileStyle.bannerFrame.borderWidthPx`	`number`	Optional	Border Width Px.
`profileStyle.bannerFrame.borderStyle`	`string`	Optional	Border Style. Allowed values: "none", "double", "solid", "dashed".
`profileStyle.bannerFrame.cornerStyle`	`string`	Optional	Corner Style. Allowed values: "default", "rounded", "sharp".
`profileStyle.memberName`	`object`	Optional	Member Name.
`profileStyle.memberName.fontFamily`	`null \| string`	Optional	Font Family.
`profileStyle.memberName.customFontId`	`null \| string`	Optional	Custom Font Id.
`profileStyle.memberName.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.memberName.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.memberName.letterSpacing`	`string`	Optional	Letter Spacing. Allowed values: "normal", "wide".
`profileStyle.memberName.smallCaps`	`boolean`	Optional	Small Caps. Allowed values: false, true.
`profileStyle.memberName.textShadow`	`boolean`	Optional	Text Shadow. Allowed values: false, true.
`profileStyle.memberName.nameEffect`	`string`	Optional	Name Effect. Allowed values: "none", "shimmer", "soft-glow".
`profileStyle.bannerImage`	`object`	Optional	Banner Image.
`profileStyle.bannerImage.brightness`	`number`	Optional	Brightness.
`profileStyle.bannerImage.contrast`	`number`	Optional	Contrast.
`profileStyle.bannerImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.bannerImage.tintOpacity`	`number`	Optional	Tint Opacity.
`profileStyle.avatarImage`	`object`	Optional	Avatar Image.
`profileStyle.avatarImage.brightness`	`number`	Optional	Brightness.
`profileStyle.avatarImage.contrast`	`number`	Optional	Contrast.
`profileStyle.avatarImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.avatarImage.tintOpacity`	`number`	Optional	Tint Opacity.
`profileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`profileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "grid", "none", "dots", "noise".
`profileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`profileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`profileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill.
`profileStyle.profileBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.profileBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.profileBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Friend-only: full Friends viewport backdrop (solid/gradient).
`profileStyle.pageBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.pageBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.pageBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Friend-only: profile card panel fill (free: preset solids; Pro+: custom solid/gradient).
`profileStyle.panelBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.panelBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex. Friend-only: optional accent mixed into the profile panel backdrop (Pro+).
`profileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex. Friend-only: optional accent mixed into section cards (Pro+).
`avatarUrl`	`null \| string`	Required	Resolved avatar URL, or null when unavailable.
`backgroundUrl`	`null \| string`	Required	Resolved background URL, or null when unavailable.
`linkedSubSystems`	`array<object>`	Optional	Linked Sub Systems. Sub systems that list this member as their linked profile (`sub_systems.linked_member_id`). Distinct from `subSystemId` (member row lives inside a sub system).
`linkedSubSystems[]._id`	`string`	Required	Unique identifier.
`linkedSubSystems[].name`	`string`	Required	Name of the resource.
`linkedSubSystems[].sideSystemId`	`string`	Required	Side System Id.

Errors

400 · JSON error: Missing member id.
401 · JSON error: Missing or invalid API key. Use Authorization: Bearer <token>.
403 · JSON error: Requires members: read_write; ownership or feature restrictions may also deny access.
404 · JSON error: Member not found.
429 · JSON error: API rate limit exceeded (1000 requests per minute). Retry shortly.
503 · JSON error: Request failed (PRECONDITION_FAILED).

Request example

Set FLORALITY_KEY in your environment. These examples use demo identifiers.

Shell

curl --request PATCH 'https://floralitys.com/api/v1/members/11111111-1111-4111-8111-111111111111' \
  --header "Authorization: Bearer $FLORALITY_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "River"
}'

Responses

Successful response.

JSON

{
  "_id": "11111111-1111-4111-8111-111111111111",
  "userId": "11111111-1111-4111-8111-111111111111",
  "directoryId": "11111111-1111-4111-8111-111111111111",
  "sideSystemId": "11111111-1111-4111-8111-111111111111",
  "subSystemId": "11111111-1111-4111-8111-111111111111",
  "name": "River",
  "displayName": "River",
  "pronouns": "they/them",
  "avatar": "demo",
  "about": "A note from our demo system.",
  "aboutTags": [
    "A note from our demo system."
  ],
  "background": "demo",
  "createdAt": 1767225600000,
  "updatedAt": 1767225600000,
  "profileStyle": null,
  "avatarUrl": null,
  "backgroundUrl": null,
  "linkedSubSystems": [
    {
      "_id": "11111111-1111-4111-8111-111111111111",
      "name": "River",
      "sideSystemId": "11111111-1111-4111-8111-111111111111"
    }
  ]
}

Example values are illustrative demo data.

Name

Type

Required

Description

memberId

string (uuid)

Required

Identifier of the member.

Request body

application/json · required

Unknown properties are rejected.

Name	Type	Required	Description
`name`	`string`	Optional	Name of the resource.
`displayName`	`string \| null`	Optional	Display name.
`pronouns`	`string \| null`	Optional	Member pronouns.
`avatar`	`string \| null`	Optional	Avatar storage reference.
`background`	`string \| null`	Optional	Background storage reference.
`about`	`string \| null`	Optional	Member profile text.
`aboutTags`	`array<string> \| null`	Optional	Tags attached to the profile text. At most 20 items.
`profileStyle`	`object \| null`	Optional	Profile presentation settings.
`profileStyle.avatarRing`	`object`	Optional	Avatar Ring. Unknown properties are rejected.
`profileStyle.avatarRing.show`	`boolean`	Optional	Show.
`profileStyle.avatarRing.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.avatarRing.shape`	`string`	Optional	Shape. Allowed values: "circle", "square", "hexagon", "octagon", "star", "pentagon", "heart", "shield", "sakura", "neko", "butterfly", "sparkle", "crown", "moon".
`profileStyle.avatarRing.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.avatarRing.animation`	`string`	Optional	Animation. Allowed values: "none", "pulse", "rotate", "shimmer".
`profileStyle.avatarRing.animationSpeed`	`integer`	Optional	Animation Speed. Minimum: 1. Maximum: 5.
`profileStyle.avatarRing.strokeStyle`	`string`	Optional	Stroke Style. Allowed values: "single", "double", "glow".
`profileStyle.avatarRing.customMaskStorageId`	`string (uuid)`	Optional	Custom Mask Storage Id.
`profileStyle.avatarRing.customMaskPathD`	`string`	Optional	Custom Mask Path D. Minimum length: 1. Maximum length: 32768.
`profileStyle.bannerFrame`	`object`	Optional	Banner Frame. Unknown properties are rejected.
`profileStyle.bannerFrame.showBorder`	`boolean`	Optional	Show Border.
`profileStyle.bannerFrame.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.bannerFrame.borderWidthPx`	`integer`	Optional	Border Width Px. Minimum: 1. Maximum: 8.
`profileStyle.bannerFrame.borderStyle`	`string`	Optional	Border Style. Allowed values: "none", "solid", "dashed", "double".
`profileStyle.bannerFrame.cornerStyle`	`string`	Optional	Corner Style. Allowed values: "default", "rounded", "sharp".
`profileStyle.memberName`	`object`	Optional	Member Name. Unknown properties are rejected.
`profileStyle.memberName.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.memberName.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.memberName.letterSpacing`	`string`	Optional	Letter Spacing. Allowed values: "normal", "wide".
`profileStyle.memberName.fontFamily`	`null \| string`	Optional	Font Family.
`profileStyle.memberName.customFontId`	`null \| string (uuid)`	Optional	Custom Font Id.
`profileStyle.memberName.smallCaps`	`boolean`	Optional	Small Caps.
`profileStyle.memberName.textShadow`	`boolean`	Optional	Text Shadow.
`profileStyle.memberName.nameEffect`	`string`	Optional	Name Effect. Allowed values: "none", "shimmer", "soft-glow".
`profileStyle.bannerImage`	`object`	Optional	Banner Image. Unknown properties are rejected.
`profileStyle.bannerImage.brightness`	`number`	Optional	Brightness. Minimum: 0.5. Maximum: 1.5.
`profileStyle.bannerImage.contrast`	`number`	Optional	Contrast. Minimum: 0.5. Maximum: 1.5.
`profileStyle.bannerImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.bannerImage.tintOpacity`	`number`	Optional	Tint Opacity. Minimum: 0. Maximum: 0.5.
`profileStyle.avatarImage`	`object`	Optional	Avatar Image. Unknown properties are rejected.
`profileStyle.avatarImage.brightness`	`number`	Optional	Brightness. Minimum: 0.5. Maximum: 1.5.
`profileStyle.avatarImage.contrast`	`number`	Optional	Contrast. Minimum: 0.5. Maximum: 1.5.
`profileStyle.avatarImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.avatarImage.tintOpacity`	`number`	Optional	Tint Opacity. Minimum: 0. Maximum: 0.5.
`profileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`profileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "none", "dots", "grid", "noise".
`profileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`profileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`profileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill. Unknown properties are rejected.
`profileStyle.profileBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.profileBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.profileBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Unknown properties are rejected.
`profileStyle.pageBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.pageBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.pageBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Unknown properties are rejected.
`profileStyle.panelBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "solid", "gradient".
`profileStyle.panelBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex.
`profileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex.
`createdAt`	`integer \| null`	Optional	Creation time.
`clientMutationId`	`string (uuid)`	Optional	Client Mutation Id.
`moveToSystemScope`	`object`	Optional	Move To System Scope.
`moveToSystemScope.sideSystemId`	`string (uuid)`	Required	Side System Id.
`moveToSystemScope.subSystemId`	`string (uuid) \| null`	Optional	Sub System Id.

Response schema

200

Successful response.

Name	Type	Required	Description
`_id`	`string`	Required	Unique identifier.
`userId`	`string`	Required	Owning account identifier.
`directoryId`	`string`	Required	Containing folder identifier.
`sideSystemId`	`string`	Optional	Side System Id.
`subSystemId`	`string`	Optional	Sub System Id.
`name`	`string`	Required	Name of the resource.
`displayName`	`string`	Optional	Display name.
`pronouns`	`string`	Optional	Member pronouns.
`avatar`	`string`	Optional	Avatar storage reference.
`about`	`string`	Optional	Member profile text.
`aboutTags`	`array<string>`	Required	Tags attached to the profile text. Labels shown on the member About card (same semantics as custom-field tags).
`background`	`string`	Optional	Background storage reference.
`archivedAt`	`number`	Optional	Archiving time; null when active.
`createdAt`	`number`	Optional	Creation time.
`updatedAt`	`number`	Optional	Most recent update time.
`deletedAt`	`number`	Optional	Deletion time; null when active.
`purgeAt`	`number`	Optional	Purge At.
`originalDirectoryId`	`string`	Optional	Original Directory Id.
`profileStyle`	`null \| object`	Required	Profile presentation settings.
`profileStyle.avatarRing`	`object`	Optional	Avatar Ring.
`profileStyle.avatarRing.show`	`boolean`	Optional	Show. Allowed values: false, true.
`profileStyle.avatarRing.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.avatarRing.shape`	`string`	Optional	Shape. Allowed values: "moon", "circle", "square", "hexagon", "octagon", "star", "pentagon", "heart", "shield", "sakura", "neko", "butterfly", "sparkle", "crown".
`profileStyle.avatarRing.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.avatarRing.animation`	`string`	Optional	Animation. Allowed values: "none", "pulse", "rotate", "shimmer".
`profileStyle.avatarRing.animationSpeed`	`number`	Optional	Animation Speed.
`profileStyle.avatarRing.strokeStyle`	`string`	Optional	Stroke Style. Allowed values: "single", "double", "glow".
`profileStyle.avatarRing.customMaskStorageId`	`string`	Optional	Custom Mask Storage Id.
`profileStyle.avatarRing.customMaskPathD`	`string`	Optional	Custom Mask Path D.
`profileStyle.bannerFrame`	`object`	Optional	Banner Frame.
`profileStyle.bannerFrame.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.bannerFrame.showBorder`	`boolean`	Optional	Show Border. Allowed values: false, true.
`profileStyle.bannerFrame.borderWidthPx`	`number`	Optional	Border Width Px.
`profileStyle.bannerFrame.borderStyle`	`string`	Optional	Border Style. Allowed values: "none", "double", "solid", "dashed".
`profileStyle.bannerFrame.cornerStyle`	`string`	Optional	Corner Style. Allowed values: "default", "rounded", "sharp".
`profileStyle.memberName`	`object`	Optional	Member Name.
`profileStyle.memberName.fontFamily`	`null \| string`	Optional	Font Family.
`profileStyle.memberName.customFontId`	`null \| string`	Optional	Custom Font Id.
`profileStyle.memberName.colorHex`	`null \| string`	Optional	Color Hex.
`profileStyle.memberName.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.memberName.letterSpacing`	`string`	Optional	Letter Spacing. Allowed values: "normal", "wide".
`profileStyle.memberName.smallCaps`	`boolean`	Optional	Small Caps. Allowed values: false, true.
`profileStyle.memberName.textShadow`	`boolean`	Optional	Text Shadow. Allowed values: false, true.
`profileStyle.memberName.nameEffect`	`string`	Optional	Name Effect. Allowed values: "none", "shimmer", "soft-glow".
`profileStyle.bannerImage`	`object`	Optional	Banner Image.
`profileStyle.bannerImage.brightness`	`number`	Optional	Brightness.
`profileStyle.bannerImage.contrast`	`number`	Optional	Contrast.
`profileStyle.bannerImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.bannerImage.tintOpacity`	`number`	Optional	Tint Opacity.
`profileStyle.avatarImage`	`object`	Optional	Avatar Image.
`profileStyle.avatarImage.brightness`	`number`	Optional	Brightness.
`profileStyle.avatarImage.contrast`	`number`	Optional	Contrast.
`profileStyle.avatarImage.tintHex`	`null \| string`	Optional	Tint Hex.
`profileStyle.avatarImage.tintOpacity`	`number`	Optional	Tint Opacity.
`profileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`profileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "grid", "none", "dots", "noise".
`profileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`profileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`profileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill.
`profileStyle.profileBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.profileBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.profileBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Friend-only: full Friends viewport backdrop (solid/gradient).
`profileStyle.pageBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.pageBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.pageBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Friend-only: profile card panel fill (free: preset solids; Pro+: custom solid/gradient).
`profileStyle.panelBackgroundFill.mode`	`string`	Optional	Mode. Allowed values: "default", "gradient", "solid".
`profileStyle.panelBackgroundFill.gradient`	`null \| object`	Optional	Gradient.
`profileStyle.panelBackgroundFill.solidHex`	`null \| string`	Optional	Solid Hex.
`profileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex. Friend-only: optional accent mixed into the profile panel backdrop (Pro+).
`profileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex. Friend-only: optional accent mixed into section cards (Pro+).
`avatarUrl`	`null \| string`	Required	Resolved avatar URL, or null when unavailable.
`backgroundUrl`	`null \| string`	Required	Resolved background URL, or null when unavailable.
`linkedSubSystems`	`array<object>`	Optional	Linked Sub Systems. Sub systems that list this member as their linked profile (`sub_systems.linked_member_id`). Distinct from `subSystemId` (member row lives inside a sub system).
`linkedSubSystems[]._id`	`string`	Required	Unique identifier.
`linkedSubSystems[].name`	`string`	Required	Name of the resource.
`linkedSubSystems[].sideSystemId`	`string`	Required	Side System Id.

Errors

400 · JSON error

Missing member id.

401 · JSON error

Missing or invalid API key. Use Authorization: Bearer <token>.

403 · JSON error

Requires members: read_write; ownership or feature restrictions may also deny access.

404 · JSON error

Member not found.

429 · JSON error

API rate limit exceeded (1000 requests per minute). Retry shortly.

503 · JSON error

Request failed (PRECONDITION_FAILED).

Request example

Set FLORALITY_KEY in your environment. These examples use demo identifiers.

Shell

curl --request PATCH 'https://floralitys.com/api/v1/members/11111111-1111-4111-8111-111111111111' \
  --header "Authorization: Bearer $FLORALITY_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "River"
}'

Responses

Successful response.

JSON

{
  "_id": "11111111-1111-4111-8111-111111111111",
  "userId": "11111111-1111-4111-8111-111111111111",
  "directoryId": "11111111-1111-4111-8111-111111111111",
  "sideSystemId": "11111111-1111-4111-8111-111111111111",
  "subSystemId": "11111111-1111-4111-8111-111111111111",
  "name": "River",
  "displayName": "River",
  "pronouns": "they/them",
  "avatar": "demo",
  "about": "A note from our demo system.",
  "aboutTags": [
    "A note from our demo system."
  ],
  "background": "demo",
  "createdAt": 1767225600000,
  "updatedAt": 1767225600000,
  "profileStyle": null,
  "avatarUrl": null,
  "backgroundUrl": null,
  "linkedSubSystems": [
    {
      "_id": "11111111-1111-4111-8111-111111111111",
      "name": "River",
      "sideSystemId": "11111111-1111-4111-8111-111111111111"
    }
  ]
}

Example values are illustrative demo data.

Update member

Parameters

Path parameters

Request body

Response schema

200

Errors

Request example

Responses

Update member

Parameters

Path parameters

Request body

Response schema

200

Errors

Request example

Responses