HEART Embedded Systems logoHEART

Problem types

CodeHTTPMeaning
invalid-request400Body or parameters fail the schema.
unsupported-version400Major version not supported.
unauthenticated401Credentials missing or invalid.
insufficient-clearance403Clearance or scope too low.
capability-not-allowed403This kind of caller may not make this request: the capability's or operation's callers excludes it, the request needs a human (such as deciding, raising the autonomy ceiling max or adopting a Playbook), or the approver is the Action's initiator.
presence-required403Approving, or a person's destructive or physical action, needs proof of presence for this Action's digest (6.3).
presence-invalid403The proof of presence did not verify (6.3).
token-not-bound401Over a network, the token must be bound to the caller's key (8.2).
signature-required403A Connected or Full system must sign the Card it joins with (10.1).
signature-invalid403The Card's signature does not verify (10.1), a brain lease or signal is not signed with the pinned Command Center key or is for another system (7.4), or an update's manifest or payload does not verify (13.2 rule 4).
identity-changed409The system joined before with a different identity key (10.1).
valve-blocked403The Valve refused to release the data.
autonomy-stopped409Refused because autonomous action is stopped.
guard-failed409A guard or interlock refused the command (Section 14.4).
caller-not-allowed403A Proposal names a target whose callers excludes ai (Core Standard 7.3). It is used only for Proposals: a caller's own request gets capability-not-allowed.
not-found404No such resource, or the caller may not know it exists, such as a property above the caller's clearance, for reading and for writing.
conflict409Invalid state, such as deciding a finished action, an actionId that was already used (6.3), or writing a read-only property.
idempotency-conflict422Key reused with a different body.
out-of-range422A value is outside the allowed range or envelope (13.2).
cannot-undo422A Trial was refused because its change cannot be undone, or the current value is unknown (13.2).
budget-exceeded429AI cost limit reached.
rate-limited429Too many requests.
internal-error500Unexpected failure.
native-failed502The device or native protocol returned an error.
native-timeout504The device did not answer in time.
not-implemented501Above this system's level.
model-unavailable503No permitted model can answer.
system-unreachable503A HEART Gateway could not reach the hosted system.

These are errors from the HEART API. A problem on a device has a fault code instead, such as HEART storage.full (H-04002): see every fault code, by H-number.