Table of Contents

Class ProblemDetailsTypes

Namespace
Excalibur.Dispatch
Assembly
Excalibur.Dispatch.Abstractions.dll

Standard Problem Details Type URIs for Dispatch error responses.

public static class ProblemDetailsTypes
Inheritance
ProblemDetailsTypes
Inherited Members

Remarks

Type URIs follow the URN format: urn:dispatch:error:{type}

Per RFC 9457 (Problem Details for HTTP APIs), Type URIs do not need to resolve to an actual resource. The URN format is preferred over URLs because:

  • URNs are explicitly non-resolvable identifiers
  • Avoids confusion when URLs don't resolve to documentation
  • Self-documenting format with clear namespace hierarchy

All type suffixes use lowercase kebab-case (e.g., not-found, rate-limited).

Fields

BackgroundExecution

Background execution error - background task execution failed.

public const string BackgroundExecution = "urn:dispatch:error:background-execution"

Field Value

string

urn:dispatch:error:background-execution

Concurrency

Concurrency error - optimistic concurrency check failed.

public const string Concurrency = "urn:dispatch:error:concurrency"

Field Value

string

urn:dispatch:error:concurrency

Conflict

Conflict error - request conflicts with current state (e.g., concurrency violation).

public const string Conflict = "urn:dispatch:error:conflict"

Field Value

string

urn:dispatch:error:conflict

Forbidden

Forbidden - the caller is authenticated but not authorized for this operation.

public const string Forbidden = "urn:dispatch:error:forbidden"

Field Value

string

urn:dispatch:error:forbidden

HandlerError

Handler error - the message handler threw an exception.

public const string HandlerError = "urn:dispatch:error:handler-error"

Field Value

string

urn:dispatch:error:handler-error

HandlerNotFound

Handler not found - no handler is registered for the message type.

public const string HandlerNotFound = "urn:dispatch:error:handler-not-found"

Field Value

string

urn:dispatch:error:handler-not-found

Internal

Internal error - an unexpected server-side error occurred.

public const string Internal = "urn:dispatch:error:internal"

Field Value

string

urn:dispatch:error:internal

MappingFailed

Mapping failed - exception mapping to problem details failed.

public const string MappingFailed = "urn:dispatch:error:mapping-failed"

Field Value

string

urn:dispatch:error:mapping-failed

NotFound

Resource not found - the requested resource does not exist.

public const string NotFound = "urn:dispatch:error:not-found"

Field Value

string

urn:dispatch:error:not-found

Prefix

The URN prefix for all Dispatch error types.

public const string Prefix = "urn:dispatch:error:"

Field Value

string

RateLimited

Rate limited - the caller has exceeded rate limits.

public const string RateLimited = "urn:dispatch:error:rate-limited"

Field Value

string

urn:dispatch:error:rate-limited

Routing

Routing error - message could not be routed to a handler.

public const string Routing = "urn:dispatch:error:routing"

Field Value

string

urn:dispatch:error:routing

Serialization

Serialization error - message serialization or deserialization failed.

public const string Serialization = "urn:dispatch:error:serialization"

Field Value

string

urn:dispatch:error:serialization

Timeout

Timeout error - the operation exceeded its time limit.

public const string Timeout = "urn:dispatch:error:timeout"

Field Value

string

urn:dispatch:error:timeout

Transport

Transport error - message transport or delivery failed.

public const string Transport = "urn:dispatch:error:transport"

Field Value

string

urn:dispatch:error:transport

Unauthorized

Unauthorized - authentication is required but was not provided or is invalid.

public const string Unauthorized = "urn:dispatch:error:unauthorized"

Field Value

string

urn:dispatch:error:unauthorized

Validation

Validation error - request data failed validation rules.

public const string Validation = "urn:dispatch:error:validation"

Field Value

string

urn:dispatch:error:validation

See Also