Docmost Octri Preview
POST/bases/rows/reorder

Reorder a row in a base

Moves a row to a new position in a base. Supply the row's UUID in rowId, the base's page UUID in pageId, and a fractional index in position to place the row between its neighbours.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields

The base, row, and fractional index that determine the row's new position. rowId, pageId, and position are required.

pageIdstringrequired
Id of the base. A base *is* a page, so this is the base's page id - the same id you would pass to the page endpoints.
positionstringrequired
Fractional index placing the row between its neighbours.
rowIdstringrequired
The UUID of the row to move.

3 status codes
200Returns a success response confirming that the row was reordered.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
403Returned when the request is forbidden or bases are not included in the current licence.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
404Returned when the base or row is not found.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

rowId, pageId, and position are required; rowId and pageId must be UUIDs. A 403 is returned when the authenticated user is forbidden from reordering rows or bases are not included in the current licence. A 404 is returned when the base or row is not found.