Browse documentation

How Sernixa works

Sernixa sits at the decision point between an AI system's intent and the code that performs the action. Your application keeps ownership of execution; Sernixa supplies consistent policy, approval, and evidence.

The decision flow

Every governed action follows the same model:

  1. Describe the intent. The caller sends a stable intent ID, operation class, risk level, data sensitivity, and systems touched.
  2. Authenticate the caller. Sernixa resolves the organization, credential, identity, and permissions.
  3. Evaluate controls. Policy, delegation scope, rate and spend limits, data rules, and approval requirements are applied.
  4. Return an outcome. The action is allowed, held for review, or blocked with a reason.
  5. Execute or stop. The caller runs the real action only after an allowed outcome.
  6. Record evidence. The decision and related events become available for operations and investigation.

Who is responsible for what

ResponsibilityOwner
Describe the proposed action accuratelyYour agent or integration
Authenticate, evaluate policy, and coordinate approvalSernixa
Run the function, tool, or MCP callYour application or host
Validate the business resultThe destination system and your application
Review governance decisions and Sernixa evidenceYour operators and reviewers

Understand the three outcomes

OutcomeWhat your integration should do
AllowContinue once, then validate and record the downstream result.
ReviewPause safely while an authorized person evaluates the request. Respect expiry and rejection.
BlockDo not execute. Show the reason to the operator and require a deliberate change before retrying.

Review is not a softer name for block. It is a distinct outcome for actions that need human judgment.

Read evidence correctly

Sernixa shows several kinds of records because they answer different questions:

RecordQuestion it answers
Registry entryWhat does the organization intend to govern?
Trust Graph pathWhich identity relationship did the organization explicitly author?
ApprovalWho reviewed this proposed action, and what did they decide?
Audit eventWhat governance activity did Sernixa record?
Discovery observationWhat candidate did a configured discovery path observe?
Accepted syncDid Sernixa accept this particular local-agent payload?
Flight Recorder eventWhat did the connected evidence path report for this runtime window?

Use the narrowest statement supported by the record. For example, inventory does not establish connectivity, a Trust Graph path does not prove a credential is usable, and a recent sync is not a continuous online-presence signal.

Organization boundary

An organization owns its members, roles, API keys, policies, registries, approvals, and evidence. Always confirm the active organization before creating credentials, changing policy, or reviewing an incident.

Next step

If you are setting up a new team, continue with Workspace and team. If the workspace already exists, govern your first action.