Skip to content

Document 404 responses for unpublished hosts #84

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
batuhan wants to merge 3 commits into from
+3 −3
Closed

Document 404 responses for unpublished hosts #84

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
42d63d4
Document 404 responses for unpublished hosts
batuhan Oct 24, 2026
0c400e0
Clarify which responses carry the undeployed marker
batuhan Oct 24, 2026
8569911
Merge main to refresh documentation build and branding
batuhan Oct 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/(reference)/limits.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,11 +99,11 @@ A space that stops serving does not fall back to a blank 404. The status code an
| Account suspended | `402` | `This space is paused.` | `403` `tenant_suspended` |
| Space disabled, expired, or taken down | `404` | `This space is no longer available.` | `409` with the disable reason |
| Removed after a legal complaint | `451` | `This content is unavailable for legal reasons.` | `409` |
| Removed under the strictest safety category | `503` | `This space hasn't been published yet.` | `409` |
| Removed under the strictest safety category | `404` | `This space hasn't been published yet.` | `409` |

Reads are never blocked by account state. Only writes are. A past-due account keeps serving every site at full speed for the whole grace period, and only the dashboard, CLI, and API stop accepting changes.

The 451 and 404 pages are customizable like any other error page. The 503 case is byte-identical to a host that has never published anything.
The legal-removal and no-longer-available pages are customizable like any other error page. The strictest-safety response is byte-identical to a host that has never published anything. The strictest-safety response and a never-published host both return `404` with `X-Spacefast-Undeployed: 1` and the unpublished body, which distinguish them from a missing page on a published site.

## Rate limits

Expand Down
2 changes: 1 addition & 1 deletion content/(serve)/urls.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,4 +94,4 @@ Any hostname ending in `.space.fast` or `.view.fast` is refused as a custom doma

## Hostnames that do not serve

A request to a hostname Spacefast does not route, or to a Space that has never published, answers `503` with `Cache-Control: no-store` and the body `This space hasn't been published yet.` It is deliberately not a 404, so a monitoring check can tell "nothing here yet" apart from "this page is missing".
A request to a hostname Spacefast does not route, or to a Space that has never published, answers `404` with `Cache-Control: no-store` and the body `This space hasn't been published yet.` The response includes `X-Spacefast-Undeployed: 1`. Use that header or the body to tell "nothing here yet" apart from a missing page on a published site.
Comment thread
indent[bot] marked this conversation as resolved.
Resolved
Loading