Restore a deleted post
POST /admin/posts/{id}/restore
Undoes a post’s soft deletion, clearing the deletion time and
reason. Whoever deleted the post can restore it, and holders of
system.admin can restore any deleted post, including one whose
deleter isn’t recorded. Being the author isn’t enough if someone
else deleted it, and despite the route, restoring your own deletion
needs no admin capability.
A post that isn’t deleted, or doesn’t exist, is 404. Restoring doesn’t change whether the post is a draft and sends no federation activity, so servers that received the deletion aren’t told. An audit entry is recorded on a best-effort basis. A post can be restored only until the retention job removes it for good.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The post’s id.
Responses
Section titled “ Responses ”The post was restored.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed