Entity Status Reference

A glossary of every status value you'll see in the Console, what it means, and what you can do from it. Written for business users — no code, no internal jargon.

A handful of states are terminal/dead and are filtered out of the command-palette search by default (they still appear on their dedicated list pages). Those are flagged below.

Customer

A customer is the top-level account that owns one or more tenants.

Status	Meaning	Typical actions
`active`	Currently a paying / live customer. Billing runs, tenants are usable.	Normal operations.
`suspended`	Temporarily paused — usually for non-payment, contract dispute, or a manual ops hold. Tenants typically frozen.	Restore to `active` once the underlying issue is resolved, or progress to `churned`.
`churned` 🪦	Customer has left. No billing, no expected return.	Read-only — kept for history and audit. Hidden from palette.

Tenant

A tenant is a single workspace under a customer. It lives on exactly one instance.

Status	Meaning	Typical actions
`requested`	A tenant has been requested but not yet picked up by provisioning.	Wait for the provisioning worker, or cancel the request.
`provisioning`	Currently being set up (DB seed, bucket creation, etc.). Brief, but visible.	Wait. If stuck, check the migration job.
`active`	Live and usable by end-users.	Normal operations.
`suspended`	Temporarily disabled — login blocked. Data retained.	Re-activate, or progress to `archived`.
`archived` 🪦	End of life. Data may be retained for compliance but the workspace is closed.	Read-only — restore requires manual intervention. Hidden from palette.
`import_failed` 🪦	Tenant import (from a migration job) failed and was not recovered.	Retry the import or archive. Hidden from palette.

User (Internal & Customer)

Users come in two flavours — internal users (your team) and customer users (their team). Both share the same status set.

Status	Meaning	Typical actions
`invited`	Invitation sent, user hasn't accepted/logged in yet.	Resend invite, revoke.
`active`	Logged in at least once and currently has access.	Normal operations.
`suspended`	Access temporarily blocked. Account retained, can be restored.	Re-activate, or progress to `deactivated`.
`deactivated` 🪦	Permanent removal from access lists. Identity preserved for audit.	Read-only — kept so historical actions still attribute to a name. Hidden from palette.

Instance

An instance is one running deployment of the platform serving a set of tenants.

Status	Meaning	Typical actions
`provisioning`	Newly registered, waiting for its first heartbeat.	Wait for it to come online.
`active`	Healthy, serving traffic.	Normal operations.
`degraded`	Heartbeat missing, error rate high, or health check failing. Still serving but unhappy.	Investigate (check logs, metrics, oncall).
`maintenance`	Manually placed into a maintenance window — traffic typically drained.	Complete the maintenance and restore to `active`.
`decommissioned` 🪦	Permanently retired. No longer accepting traffic.	Read-only — kept for audit.

Migration Job

Jobs handle bulk tenant operations: import, export, clone, instance-replace, etc.

Status	Meaning	Typical actions
`queued`	Created, waiting for a worker to pick it up.	Wait, or cancel.
`running`	Actively executing.	Watch the live log.
`succeeded`	Finished cleanly.	Review the report; close the loop.
`failed`	Stopped mid-flight with errors.	Inspect the failure, fix the root cause, then rerun — rerun resumes only the failed work.

Release

A release rolls a new version out across stages (e.g. dev → qa → prod).

Status	Meaning	Typical actions
`draft`	Not yet started.	Trigger when ready.
`in_progress`	Rolling through stages.	Monitor stages; approve gates.
`paused`	Manually halted between stages — common when waiting on validation.	Resume, or cancel.
`completed`	Successfully reached the final stage everywhere.	Done.
`failed`	A stage failed and stopped the rollout.	Investigate, retry, or roll back.
`rolled_back`	Manually reverted to the previous version.	Capture lessons; plan the next attempt.
`cancelled`	Aborted before completion.	Document why; trigger a fresh release if needed.

Invoice

Status	Meaning
`draft`	Being built — not yet visible to customer.
`issued`	Sent to customer; payment expected.
`paid`	Settled in full.
`overdue`	Past due date, unpaid.
`void`	Cancelled — never to be paid.
`refunded`	Previously paid, money returned.

Payment

Status	Meaning
`pending`	Submitted to the payment provider, awaiting confirmation.
`succeeded`	Cleared.
`failed`	Provider rejected (insufficient funds, expired card, etc.).
`refunded`	Money returned to the customer.

Notes for non-technical readers

🪦 means "dead state" — the entity is preserved for history but is no longer expected to be acted on. The Console hides these from search-by-default views (like the command palette) so you can find live records faster. They're still accessible from the entity's dedicated list page.
active is always the live, normal state across every entity.
Suspension is reversible, deactivation/archival/churn/decommissioning is not (without manual intervention).
If you see a status not listed here, ping engineering — it may be a new state added after this doc was last updated.

Entity Status Reference ​

Customer ​

Tenant ​

User (Internal & Customer) ​

Instance ​

Migration Job ​

Release ​

Invoice ​

Payment ​

Notes for non-technical readers ​