Docmost Octri Preview
POST/spaces/delete

Delete a space

Deletes a space. Provide the spaceId of the space to remove. The authenticated user needs Manage/Settings permission for the space.

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

1 body field

The space to delete.

spaceIdstringrequired
Space identifier (UUID).

3 status codes
200Confirms that the space was deleted.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
403Returned when the authenticated user lacks permission to delete the space.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
404Returned when the specified space does not exist.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 403 is returned when the authenticated user lacks Manage/Settings permission for the space. A 404 is returned when the spaceId does not identify an existing space.