Edit floor

This API updates an existing floor’s profile metadata using multipart form data.

A floor can be edited only by its owner.
If the authenticated user is not the owner of the floor, the request will be rejected, even if the user is a member or follower of the floor.

The API allows the floor owner to update:

Floor title

Floor details/description

Floor logo/avatar image

After a successful update, the API returns the latest floor object, including the updated avatar and the current list of blocks associated with the floor.

Authorization Rules (Critical)

The caller must be authenticated

The caller must be the owner of the floor

Members, followers, or pod consumers cannot edit the floor

Ownership is validated internally using the authenticated user context

Ownership is mandatory. There are no partial permissions for this API.

Content-Type

multipart/form-data

Request Body (Multipart Form Data)

Form Fields

Field Name	Type	Required	Description
`floor_id`	String	Optional*	Public / human-readable floor identifier
`title`	String	Optional	New floor title
`details`	String	Optional	New floor description
`logo`	File	Optional	New floor logo image (PNG/JPG/WebP)

At least one floor identifier (fid or floor_id) must be provided.
Best practice: Use fid as the primary identifier.

Update Rules

At least one of title, details, or logo must be present

Missing update fields result in a validation error

If logo is provided, the previous logo is replaced

Response Format

application/json

Sample Success Response

{
  "floor_id": "my_floor",
  "title": "daughter ouch upon yummy clamor",
  "details": "nostrud occaecat incididunt dolor adipisicing",
  "fid": "86",
  "blocks": [
    {
      "bid": "83",
      "type": "pariatur",
      "title": "wherever demobilise acidly refute"
    }
  ],
  "avatar": {
    "url": "https://legal-availability.name/",
    "id": "98"
  }
}

Error Responses (Authorization Focus)

Not Floor Owner

{
  "status": "ERROR",
  "message": "Only the floor owner can edit this floor"
}

Floor Not Found

{
  "status": "ERROR",
  "message": "Floor not found"
}

No Update Fields

{
  "status": "ERROR",
  "message": "No update fields provided"
}

Notes

This API is owner-only by design

Pods and developer tools must operate using owner credentials

Blocks are returned for convenience but are not editable through this API

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Authorization Rules (Critical)#

Content-Type#

Request Body (Multipart Form Data)#

Form Fields#

Update Rules#

Response Format#

Sample Success Response#

Error Responses (Authorization Focus)#

Not Floor Owner#

Floor Not Found#

No Update Fields#

Notes#

Request

Responses