Docmost Octri Preview
POST/favorites/remove

Remove an item from favorites

Removes a page, space, or template from the authenticated user's favorites. Set type and provide the corresponding ID field: pageId, spaceId, or templateId.

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

4 body fields

Favorite target details. Specify type and the matching ID field: pageId for a page, spaceId for a space, or templateId for a template.

pageIdstringoptional
UUID of the page to remove when `type` is `page`.
spaceIdstringoptional
UUID of the space to remove when `type` is `space`.
templateIdstringoptional
UUID of the template to remove when `type` is `template`.
typestringrequired
Favorite target type: `page`, `space`, or `template`.
Allowed:pagespacetemplate

4 status codes
200Returns a response payload confirming the favorite was removed.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
400Returned when the ID matching `type` is missing or invalid.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Returned when the authenticated user is forbidden from removing the target from favorites.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
404Returned when the specified target does not exist.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned when type is missing or its corresponding ID is missing or invalid. A 403 is returned when the authenticated user is not permitted to remove the target from favorites. A 404 is returned when the target identified by the matching ID does not exist.