Docs

Errors

Handle LunnoaApiError status helpers in @lunnoa/client.

Failed HTTP calls throw LunnoaApiError with status helpers you can branch on.

Status helpers

PropertyMeaning
statusHTTP status code
bodyParsed error payload when available
isUnauthorized401 (missing or revoked credential)
isForbidden403 (role or licence edition does not cover the endpoint)
isRateLimited429 (back off and retry)

Example

errors.ts
import { LunnoaApiError } from '@lunnoa/client';try {  await lunnoa.workflows.execute(workflowId, inputs);} catch (error) {  if (error instanceof LunnoaApiError && error.isForbidden) {    // Hide the capability or prompt for a stronger role  }  throw error;}

Practical mapping:

  • 401 → with createBrowserClient / a tokenStore, the SDK auto-refreshes once by default; otherwise call auth.refresh() or send the user through login again. For Pattern A, rotate or replace the API key.
  • 403 → hide the capability; the key's role or the deployment's licence edition does not cover the endpoint
  • 429 → back off and retry

For minting keys and RBAC, see API authentication. For login and refresh helpers, see Authentication.

Next