Delete Status Page

​

Overview

​

Authentication

• API Key: X-API-Key: YOUR_API_KEY

​

Path Parameters

​

Request Example

DELETE /api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000

​

Response

​

Success Response (200 OK)

{
  "success": true,
  "data": {
    "message": "Status page deleted successfully"
  }
}

• Be excluded from list queries
• Not appear in dashboards
• Be inaccessible to the public via its URL
• Retain historical data for auditing
• No longer receive incident updates

​

Soft Delete Behavior

1. Database Flag: The is_deleted flag is set to true
2. Public Access Blocked: The status page URL becomes inaccessible (404)
3. Excluded from Queries: All future queries exclude soft-deleted status pages
4. Historical Data Retained: Incident history, subscriber data, and metrics remain available for:
   • Historical analysis
   • Audit trails
   • Compliance reporting
5. Immediate Effects:
   • Status page stops appearing in list responses
   • Public URL returns 404 Not Found
   • No new incidents can be created on the page
   • Incident notifications are not sent
   • Status page is unavailable for updates or viewing

​

Data Retention

• Historical incident records
• Component status history
• Monitor status snapshots
• Subscriber information
• Performance metrics
• Audit logs

• Cannot be accessed through normal API queries
• Can be accessed by administrators for audit purposes
• Is retained according to your plan’s data retention policy
• May be permanently deleted during account cleanup

​

Plan Limit Impact

• Immediately frees up status page slot in your active count
• Allows creation of new status pages if limit is reached
• Does not affect billing for the current billing cycle
• Frees up potential subdomain for future use

​

Incident Notifications

• Existing email subscribers no longer receive updates
• Active incidents on the page are archived
• Email subscription list is retained for audit purposes

​

Error Codes

​

Error Responses

​

400 Bad Request

{
  "success": false,
  "error": {
    "code": "INVALID_STATUS_PAGE_ID",
    "message": "Missing or invalid status page ID"
  }
}

​

401 Unauthorized

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication is required to access this resource"
  }
}

​

403 Forbidden

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to delete this status page. Project Admin role required."
  }
}

​

404 Not Found

{
  "success": false,
  "error": {
    "code": "STATUS_PAGE_NOT_FOUND",
    "message": "Status page not found or already deleted"
  }
}

​

Examples

# Delete a status page
curl -X DELETE https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"

# Delete and check response
curl -i -X DELETE https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"

​

Important Notes

​

Irreversible Operation

• The status page will not reappear through normal operations
• Historical data is archived and not directly accessible
• The public URL cannot be recovered

​

Restore Options

1. Contact support with the status page ID and original configuration
2. An administrator can un-delete the status page within the retention period
3. For permanent records, export your status page configuration regularly

​

Public URL Impact

• The public URL (e.g., status-prod.uptimeio.com) becomes inaccessible
• Users attempting to access the URL receive a 404 error
• Email subscribers receive no further notifications
• Bookmarks and shared links to the page no longer work

​

Audit Logging

• Logged with timestamp and user information
• Included in project audit trails
• Available for compliance and security reviews
• Retained according to data retention policies

​

Before Deleting

• Exporting Configuration: Save status page settings and monitor list if needed later
• Checking Subscribers: Review number of email subscribers who will lose updates
• Public References: Check if status page URL is referenced in documentation or marketing materials
• Active Incidents: Ensure no ongoing incidents that subscribers should be notified about
• Archival: Consider pausing instead of deleting if you might need it later

​

Notification of Deletion

• Subscribers do not receive automatic deletion notification
• Consider sending a final email notification before deletion
• The status page becomes inaccessible immediately

​

Data Governance

​

Data Retention Timeline

• 30 days: Soft-deleted status page data can be restored by support
• 90 days: Page available for audit purposes only
• 365 days+: Automatic permanent deletion based on plan policies

​

Compliance Considerations

• Non-destructive to historical records
• Maintains audit trail integrity
• Supports data retention policies
• Enables regulatory compliance reviews