Skip to content
Suggest a correction

Result statuses and card labels

Reference3 min read

Translate what the Record Health Check card shows into the status that Flow, Apex, Platform Events, Agentforce actions, and the REST API return for the same result. People read the card label; automation must use the status.

A result reports whether a record meets a requirement. A FAIL never blocks a Salesforce save, and it is not a Flow fault or an Apex exception.

Card labelStatusMeaningWhat automation should do
PassPASSThe record meets the requirement.Continue.
Failed, Warning, or InfoFAILThe record does not meet the requirement. The label comes from the Check’s Failure Severity.Take the business follow-up action.
SkippedSKIPPEDThe Check did not apply to the record, its prerequisite did not pass, or its empty-result setting skips it.Decide whether a skip is acceptable for the process.
Unable to CheckUNABLE_TO_EVALUATEAccess, data, configuration, or a limit prevented a reliable answer.Route to an administrator with the Reason Code.
System ErrorERRORAn unexpected problem in Record Health Check or a custom Apex Check stopped the Check.Route for technical investigation with the Diagnostic ID.

Setup and the API call the fourth status Unable to Evaluate (UNABLE_TO_EVALUATE); the card shows Unable to Check.

Failure Severity on a Check changes only how a FAIL looks on the card:

Failure SeverityCard labelColor
CriticalFailedRed
WarningWarningAmber
InfoInfoBlue

Warning is the default. Every severity is still the status FAIL in Flow, Apex, Platform Events, Agentforce, and the REST API, which return the severity separately as CRITICAL, WARNING, or INFO.

The card’s summary counts results in pills, using these labels: N Passed, N Failed, N Warning or Warnings, N Info, N Skipped, N Unable, and N System Error or System Errors. A pill appears only when its count is above zero.

For a whole Check Set, the Flow action, Agentforce action, and REST API report the most serious status among its Checks, in this order:

  1. ERROR
  2. UNABLE_TO_EVALUATE
  3. FAIL
  4. PASS
  5. SKIPPED

A Check Set where three Checks pass and one fails is FAIL. Use the counts to tell a mixed run from one where every Check had the same result.

Check Success first, then route on Status:

Flow outputMeaning
Success = falseThe request was rejected. Read Error Type and Error Message. Status is blank.
Success = true and Status = PASSThe record meets every requirement that applied.
Success = true and Status = FAILThe record does not meet a requirement. This is not a Flow fault.
Success = true and another statusRoute SKIPPED, UNABLE_TO_EVALUATE, and ERROR on paths of their own.
The fault path runsA Salesforce error, such as an exhausted governor limit, stopped the action before it returned outputs.

Never branch on message text, which an administrator can change. Use Status, the counts, and Reason Code.

When Found or Expected is a list, the card shows at most 10 of its values. The rest of the list is still used for the comparison. Use the Check’s operator and counts, not the visible values, to explain the result.

  1. Note the status, the Reason Code, and any Diagnostic ID shown.
  2. Ask an administrator to turn on Show Diagnostics for the investigation.
  3. Follow Troubleshoot with Show Diagnostics.