Docs

Errors & limits

Every error is an HTTP status and { "error": { "code": "…", "message": "…" } }; the SDKs turn it into an exception.

import { HaltoUnavailableError } from "@halto/sdk";

try {
  const r = await halto.check(input);
} catch (err) {
  if (err instanceof HaltoUnavailableError) {
    console.error("Halto can't be reached: not running the action");
  }
  throw err;
}

If Halto can't be reached, the action doesn't run

The SDKs throw, and there is no setting that lets it through instead. An error inside Halto blocks the action too. More.

Error codes

StatusCodeMeaningWhat to do
400invalid_request · invalid_jsonA request Halto can't read.Fix it: message says what is wrong.
400invalid_target_urlA webhook address Halto won't call.Use a public https:// address.
401missing_api_key · invalid_api_keyNo key, or a wrong or revoked one.Send Authorization: Bearer hk_….
402data_guard_limit/v1/clean: the plan's hidden values for this month are used up, so the text is held back.message says how to go on.
403demo_workspaceThe key is from a demo workspace with sample data.Create your own workspace for real agents.
404not_foundAn unknown id.Check the id, and that it belongs to this agent.
409too_many_hooksAn agent can have at most 20 webhooks.Delete unused ones first.
413payload_too_largeThe body is too large.Send less at once.
429rate_limitedToo many requests from this agent.Wait retry_after seconds. The SDKs wait and retry.
429too_busyOne workspace sends more at once than its share.Wait retry_after seconds. The SDKs wait and retry.
500internal_errorSomething went wrong inside Halto: the action is blocked.Try again later.
503database_busyHalto under a burst.Wait retry_after seconds. The SDKs wait and retry.
503data_guard_busy/v1/clean: Halto's model couldn't check the text for names and addresses just now, so it is held back.Try again in a minute.

On this page