Lifecycle and governance policy
Each system has a governance state beside its operational status. The operational status says whether it is registered, healthy and reachable; the governance state says whether it has been assessed, put into service, suspended or withdrawn under the Act. Every transition is an immutable event with a reason, the person who made it, any approver, and the system’s mandatory readiness at that moment. You manage the state on a system’s Governance › Governance lifecycle page. The State log there lists every event.States
Only Suspended (and the deregistration at the end of a retirement) changes
traffic. A system in Draft, Assessed or Retiring keeps serving.
Transitions
Every manual transition needs a free-text reason. Reclassifying a system does
not move it out of In service (except to Suspended when the new tier is
Prohibited); use Require reassessment when the change is substantial.
Suspension
Suspend is the kill switch with a governance reason attached. It is available only for a system that is In service.
What it does, and does not do:
- It freezes the agent or MCP server through the same kill switch as the
Freeze button. Every request to it is refused with
Sink agent is frozen, whatever else is true about it. - LLM gateways cannot be suspended: they have no kill switch. Suspend the agents that use the gateway instead.
- While the governance state is Suspended, the kill switch cannot be released by hand. Unfreezing directly is refused; lifting the suspension releases it.
- Suspension does not notify anyone. Tell dependants yourself, or retire the system, which does notify them.
- It is not available from Draft or Assessed. To stop a system in those states — for example one you have just classified Prohibited — use the Freeze button on its page.
Lifting a suspension
Lift suspension returns the system to In service and releases the kill switch. For an effective tier of High-risk or High-risk (exempt), it instead creates an approval request: the system stays suspended until a different person approves it in Govern › Approvals, Governance tab. A rejected request changes nothing; request the lift again when ready.Retirement
Retirement withdraws a system with evidence instead of simply deleting it. Open it with Retire… on the lifecycle page. A drawer walks through five steps — Reason, Impact, Evidence, Approval, Confirm — and Open the case on the first step moves the system to Retiring. A case can be opened from any state except Retiring and Retired, and the system keeps serving until the case is completed.1
Say why
Choose a reason and describe it. For a corrective retirement, say whether
the system is withdrawn from the market or recalled from users, and
optionally name the successor system.
For the two corrective reasons, dependants are notified as soon as the
case is opened.
2
Review who is affected
The case shows the impact: agents sending to it and agents it sends to,
people subscribed, channels routing to it, MCP servers and gateways it
uses (and whose inherited tier will drop), policy bindings that name it,
open human-review holds, and monitors that filter on it.
3
Work through the evidence checklist
Mandatory items must be satisfied before the case can complete:
4
Get the second signature (high-risk tiers)
For an effective tier of High-risk or High-risk (exempt), opening the case
creates an approval request in Govern › Approvals, Governance tab.
A different person must approve it. If it is rejected, cancel the case
and open a new one when ready.
5
Complete
On the Confirm step, type the system’s name and press Retire.
Completion happens in one step: dependants are notified, the system is
deregistered, the RETIRED event is written, the retention dates are set
and the record is snapshotted.
While a case is open, the lifecycle page shows it with its checklist,
approval status and Cancel case. To pick it up again — for example once
the second signature is in — press Continue retirement…; the drawer
opens at the step the case has reached.
What completion does
- Notifies dependants by e-mail: the system’s owner, deputy and oversight persons, the people subscribed to it, and the owners of agents and MCP servers connected to it. Who was addressed is recorded as an event on the audit chain even if a mailbox bounces. Delivery needs notification-service and SMTP — see Configuration.
- Deregisters the system through the normal path: its subscriptions and grants are removed and traffic to it stops.
- Sets the retention holds:
- logs: the completion date plus the larger of 183 days and the governance policy’s minimum retention;
- documentation: 10 years from when the system was first put into service, or from completion if it never was.
- Takes an immutable snapshot of the whole record. From then on the evidence pack is read from the snapshot.
- Seals the snapshot with an audit integrity checkpoint shortly afterwards (the platform waits about 15 seconds so the checkpoint covers the retirement events, then requests it). The case shows the checkpoint id once sealed.
AUDIT_QTS_ENABLED=true, off by
default; set it under services.audit.settings — see
Per-service overrides).
Without it, the checkpoint is signed and hash-chained but not timestamped by
a third party.
Tenant governance policy
Manage › Governance policy holds the tenant-wide rules. Anyone with Tenant Read can view it; editing needs Tenant Admin. Every save creates a new numbered version with an optional reason and an audit event; until the first save, the platform defaults apply.
Some details worth knowing:
- Additional required documents only promote. They make an advisory document obligation that already applies count as mandatory (for example the DPIA for a High-risk deployer). Adding a kind that no obligation asks for at that tier has no effect, and nothing can make a default-mandatory obligation optional.
- Review intervals are applied at signing. Existing review dates are not recalculated when you change an interval.
- Through the API, a save replaces the whole policy.
PUT /registry/v1/tenants/{tenantId}/governance-policyfills any field you leave out with the platform default, not with your previous value. Read the current policy first and send it back with your change.
There are two retention floors. The governance policy’s Minimum audit
retention is used for the log retention hold when a system is retired. The
Logs kept at least six months readiness check reads a separate floor held
by audit-service (
GET /audit/v1/retention), which is 183 days unless
changed through that API. Keep both at or above 183 days; neither schedules
deletion.What the gate checks
The gate runs on four actions:
What it decides:
- A Prohibited system is always refused, in every mode.
- A Retired system is always refused, except for marketplace publish.
- Otherwise only systems whose effective tier is High-risk (exempt) or
High-risk are checked. For them, the gate takes the unmet mandatory
obligations from readiness:
- under Warn, the action goes ahead and the response carries a
gateobject listing what is unmet (the UI shows it as a warning); - under Block, the action is refused with HTTP 409 and the same
gateobject, so a client can show exactly what to fix.
- under Warn, the action goes ahead and the response carries a
- Publishing an unclassified agent to the marketplace always returns a warning that it has no classification. It is never blocked.
- For every other tier, the gate says nothing.
API
Through the gateway, under/registry. Replace agents/{agentId} with
mcp-servers/{mcpServerId} or llm-gateways/{llmGatewayId} for the other
subject types.
Next
Overview
Where things live, day one after upgrading, permissions.
Classification
Risk tiers, the wizard, second signatures and inherited tiers.
Governance record
Owners, oversight, documents, readiness and Art. 50 transparency.
Incidents and evidence
Serious incidents, the register, exports and the evidence pack.
