Update space
Updates space for the authorised account.
PATCH
/api/v1/messaging/spaces/{spaceId}messaging: read_write1,000 requests/minute/key · all plansActive API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.
Message storage
Message text is encrypted at rest and decrypted for authorised requests. Channel access is restricted to spaces owned by the API key’s account; missing or inaccessible channels return 404. Editing or deleting a message additionally checks its author and can return 403.
Space icon uploads
GIF space icons require Pro. Uploads must belong to the account and remain within its file-upload allowance. Other icon formats do not require a paid plan solely because this is a messaging endpoint.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
spaceId | string (uuid) | Required | Identifier of the space. |
Request body
application/json · required
Unknown properties are rejected.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Optional | Name of the resource. Minimum length: 1. Maximum length: 120. |
description | string | null | Optional | Description of the resource. Maximum length: 500. |
iconStorageRef | string | null | Optional | Icon Storage Ref. Maximum length: 1000. |
iconStagingId | string (uuid) | null | Optional | Icon Staging Id. |
Response schema
200
Successful response.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | Unique identifier. |
name | string | Required | Name of the resource. |
userId | string | Required | Owning account identifier. |
updatedAt | number | Required | Most recent update time. |
description | null | string | Required | Description of the resource. |
createdAt | number | Required | Creation time. |
deletedAt | null | number | Required | Deletion time; null when active. |
sideSystemId | null | string | Required | Side System Id. |
version | number | Required | Version used for optimistic concurrency checks. |
sortOrder | number | Required | Sort Order. |
purgeAt | null | number | Required | Purge At. |
archivedAt | null | number | Required | Archiving time; null when active. |
iconStorageRef | null | string | Required | Icon Storage Ref. |
createdByUserId | string | Required | Created By User Id. |
Errors
400· JSON errorRequest failed (BAD_REQUEST).
401· JSON errorMissing or invalid API key. Use Authorization: Bearer <token>.
403· JSON errorRequires messaging: read_write; ownership or feature restrictions may also deny access.
404· JSON errorRequest failed (NOT_FOUND).
409· JSON errorconflict.
429· JSON errorAPI rate limit exceeded (1000 requests per minute). Retry shortly.
500· JSON errorinternal server error.
503· JSON errorObject storage is not configured. Set MinIO (or compatible S3) env vars to upload files.
Request example
Set FLORALITY_KEY in your environment. These examples use demo identifiers.
curl --request PATCH 'https://floralitys.com/api/v1/messaging/spaces/11111111-1111-4111-8111-111111111111' \
--header "Authorization: Bearer $FLORALITY_KEY" \
--header "Content-Type: application/json" \
--data '{
"name": "River"
}'Responses
Successful response.
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "River",
"userId": "11111111-1111-4111-8111-111111111111",
"updatedAt": 1767225600000,
"description": null,
"createdAt": 1767225600000,
"deletedAt": null,
"sideSystemId": null,
"version": 0,
"sortOrder": 0,
"purgeAt": null,
"archivedAt": null,
"iconStorageRef": null,
"createdByUserId": "11111111-1111-4111-8111-111111111111"
}Example values are illustrative demo data.