Skip to content

Restore a soft-deleted post

POST
/admin/posts/{id}/restore

Clears deleted_at + deleted_reason on the post row and fires an admin.post.restored audit event.

AUTHORISATION is the same rule as POST /admin/assets/{id}/restore: you may undo your own delete, system.admin may undo any, and a NULL deleted_by_user_ref is restorable by system.admin only (#931).

Returns 404 if the post is already live (or doesn’t exist); 403 when the caller did not delete it.

id
required
string format: uuid

Restored

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed