---
title: workflow/errors
description: Semantic error types thrown by the Workflow SDK and its storage backends.
docs_index: /llms.txt
lastUpdated: 2026-11-16
type: overview
summary: Explore the error classes exported from workflow/errors for handling workflow failures.
related:
  - /docs/foundations/errors-and-retries
---

> For an index of all documentation, see [/llms.txt](/llms.txt).

API reference for the error classes exported from the `workflow/errors` package.

All errors extend [`WorkflowError`](/docs/api-reference/workflow-errors/workflow-error), so you can catch any SDK error with a single `instanceof` check, or narrow to a specific class for fine-grained handling.

## Base classes

#### [WorkflowError](/docs/api-reference/workflow-errors/workflow-error)

Base class for all workflow error types.

#### [WorkflowWorldError](/docs/api-reference/workflow-errors/workflow-world-error)

Base error for failures from workflow storage backends.

## Registration errors

#### [WorkflowNotRegisteredError](/docs/api-reference/workflow-errors/workflow-not-registered-error)

Thrown when a workflow function is not registered in the current deployment.

#### [StepNotRegisteredError](/docs/api-reference/workflow-errors/step-not-registered-error)

Thrown when a step function is not registered in the current deployment.

## Run errors

#### [WorkflowRunNotFoundError](/docs/api-reference/workflow-errors/workflow-run-not-found-error)

Thrown when operating on a workflow run that does not exist.

#### [WorkflowRunFailedError](/docs/api-reference/workflow-errors/workflow-run-failed-error)

Thrown when awaiting the return value of a failed workflow run.

#### [WorkflowRunCancelledError](/docs/api-reference/workflow-errors/workflow-run-cancelled-error)

Thrown when awaiting the return value of a canceled workflow run.

#### [WorkflowRunNotCompletedError](/docs/api-reference/workflow-errors/workflow-run-not-completed-error)

Thrown when requesting the result of a workflow run that has not completed yet.

#### [WorkflowRuntimeError](/docs/api-reference/workflow-errors/workflow-runtime-error)

Thrown when the workflow runtime encounters an execution error, such as serialization failures or timeouts.

#### [WorkflowStartError](/docs/api-reference/workflow-errors/workflow-start-error)

Thrown when `start({ experimental_hook })` cannot confirm whether its run was queued or admitted.

#### [RunExpiredError](/docs/api-reference/workflow-errors/run-expired-error)

Thrown when a workflow run has expired and can no longer be operated on.

#### [RunNotSupportedError](/docs/api-reference/workflow-errors/run-not-supported-error)

Thrown when a workflow run requires a newer workflow spec version than the installed SDK supports.

## Hook errors

#### [HookNotFoundError](/docs/api-reference/workflow-errors/hook-not-found-error)

Thrown when resuming a hook that does not exist.

#### [HookConflictError](/docs/api-reference/workflow-errors/hook-conflict-error)

Thrown when creating a hook with a token that is already in use by another workflow run.

#### [HookForceClaimedError](/docs/api-reference/workflow-errors/hook-force-claimed-error)

Thrown to a hook's awaiters when another run takes its token over with `experimental_force`.

## Backend errors

#### [ThrottleError](/docs/api-reference/workflow-errors/throttle-error)

Thrown when a request is rate-limited by the workflow backend.

#### [EntityConflictError](/docs/api-reference/workflow-errors/entity-conflict-error)

Thrown when a storage operation conflicts with the current entity state.

#### [PreconditionFailedError](/docs/api-reference/workflow-errors/precondition-failed-error)

Thrown when an event creation is rejected because the client's event-log snapshot is stale.

#### [InBandSupersededError](/docs/api-reference/workflow-errors/in-band-superseded-error)

Thrown on the experimental spec 9 runtime when a World refuses an in-band write from a superseded orchestrator invocation.

#### [TooEarlyError](/docs/api-reference/workflow-errors/too-early-error)

Thrown when a request is made before the system is ready to process it.

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)