Project lifecycle
Every app has an owner and an expiry, so nothing is left running unowned or forgotten. The rules below run automatically; admins and owners can also act by hand. Every action is audited.
States
| State | App | Data | Visitors see |
|---|---|---|---|
| Active | Running | Kept | The app |
| Stale | Running (a label, not a separate state) | Kept | The app; the owner has been nudged |
| Archived | Stopped | Kept: database, files and settings | "Archived", naming the owner |
| Disabled | Stopped by IT's kill switch | Kept | "Disabled by IT" |
Archived and disabled apps also block their database and storage APIs (PROJECT_ARCHIVED, PROJECT_DISABLED). Their integration calls stop.
Stale projects and expiry
- A project with no activity for 60 days is stale, and the owner gets a nudge.
- If nobody opens or renews it in the next 30 days, it's archived.
Activity means someone opened the app, it was created or restored, or the owner selected Renew. Org Admins change both numbers on Admin › Roles.
The project's Settings › General › Expiry shows when it would be archived, for example "Archived around Mar 3 (42 days) if nobody opens it for 60 days." The owner or an admin can select Renew to reset the clock.
Owners who leave
When an owner's account is turned off or removed from the directory, Org Sync notices, and the project moves to their nearest enabled manager. The new owner gets a notification with keep, transfer or archive. If there's no enabled manager up the chain, Org Admins are told instead.
Archive and restore
| Who | Where |
|---|---|
| Owner, Org Admin, Delegated Admin in scope | Project › Settings › Danger zone › Archive project / Restore project |
| Org Admin, Delegated Admin in scope | Admin › Projects › project drawer › Archive / Restore |
Restoring starts the app again and counts as activity.
Kill switch
The kill switch stops an app immediately. The Hub tells the Edge to drop its cached decisions, so the next request already sees "Disabled by IT". The owner can't re-enable it; only an Org Admin or a Delegated Admin in scope can.
- Open Admin › Projects and select the project's row.
- Optionally enter a Reason (shown to people).
- Select Kill switch. Select Re-enable to bring it back.
To stop every app a person owns at once, use Disable all of <name>'s projects in the same drawer, and Re-enable all to undo it.
# The same through the admin API (as an Org Admin or a Delegated Admin in scope)
curl -X POST https://console.<your-domain>/api/admin/projects/<name>/disable \
-H "Authorization: Bearer $TOKEN" \
-H 'content-type: application/json' -d '{"reason":"security review"}'
Transfer ownership
The new owner gets every right the old owner had and a notification. The project moves to the new owner's place in the org tree, so its cost and rollups move too.
- Owner or admin: Project › Settings › General › Transfer.
- Org Admin or Delegated Admin: Admin › Projects › drawer › Transfer to › Transfer.
Delete
Deleting is permanent and is covered in Deployment. Archive is the reversible option.