Skip to main content
The Delete Page endpoint permanently removes a page from your Pharen Hub workspace. Once deleted, the page and all its content are gone — there is no recycle bin or soft-delete behaviour accessible through the API. Use this endpoint with care, and consider confirming with your users before making irreversible deletions in client applications.

​
Endpoint

DELETE https://api.pharen.de/v1/new-page/{id}

​
Path Parameters

​
id
string
required
The unique identifier of the page to delete. You can retrieve this from the List Pages endpoint.

​
Request Example

curl https://api.pharen.de/v1/new-page/page_01hx9k2m3nqvw4e5r6t7y8u9p \
  --request DELETE \
  --header "Authorization: Bearer YOUR_API_KEY"
A successful delete request returns 204 No Content with an empty response body — there is nothing to parse or deserialize. Make sure your HTTP client handles empty responses without throwing an error.

​
Response

A successful deletion returns 204 No Content with no response body.
StatusBodyMeaning
204 No Content(empty)The page was found and successfully deleted.
401 UnauthorizedError objectYour API key is missing or invalid.
403 ForbiddenError objectYour API key does not have permission to delete this page.
404 Not FoundError objectNo page with the given ID exists in this workspace.

​
Error Responses

Page not found (404): 
{
  "error": {
    "code": "not_found",
    "message": "No page with ID 'page_01hx9k2m3nqvw4e5r6t7y8u9p' exists in this workspace."
  }
}
Insufficient permissions (403): 
{
  "error": {
    "code": "insufficient_permissions",
    "message": "Your API key does not have permission to delete pages in this workspace."
  }
}
Deletion is permanent and immediate. There is no confirmation step, no soft delete, and no API-level undo. If your integration deletes pages in bulk, build in safeguards — such as a dry-run mode that lists pages before deleting them — to prevent accidental data loss.