DocsStatus Handling

Status Handling

Status Meaning Typical presentation
ACTIVE Last successful validation was PASS or PASS WITH WARNINGS. Show it.
DEGRADED A temporary or quality problem was detected on later health checks. Show with caution, or hide from the default listing.
REMOVED The app should normally no longer be presented as active. Drop it from user-facing lists. Keep the id if you need history.

Consuming projects can choose their own presentation rules. PWARegistry only reports the status.

Default browse, search, category files, and GET /api/v1/apps return ACTIVE unless you ask otherwise.

if (app.status === "ACTIVE") show(app);
else if (app.status === "DEGRADED") showWithWarning(app);
else hide(app); // REMOVED

Static indexes:

  • /registry/v1/status/active.json
  • /registry/v1/status/degraded.json
  • /registry/v1/status/removed.json

API: GET /api/v1/apps?status=degraded or status=all.

A later submit or a successful health pass can move a removed id back to ACTIVE. Validation result on the record is informational; admission already required PASS or PASS WITH WARNINGS. Later failures are expressed through status.