# TX_COORDINATOR_NOT_CONFIGURED — distributed transaction coordinator is not enabled

Certain operations that span multiple storage shards require a distributed transaction coordinator. This error is returned when such an operation is attem…

<em>cyoda-go version <a href="https://github.com/Cyoda-platform/cyoda-go/releases/tag/v0.6.2">0.6.2</a></em>

# errors.TX_COORDINATOR_NOT_CONFIGURED

## NAME

TX_COORDINATOR_NOT_CONFIGURED — the request requires a distributed transaction coordinator but none is configured on this node.

## SYNOPSIS

HTTP: `503` `Service Unavailable`. Retryable: `no`.

## DESCRIPTION

Certain operations that span multiple storage shards require a distributed transaction coordinator. This error is returned when such an operation is attempted on a node where the coordinator component is disabled or misconfigured.

Not retryable on this node. Distributed transaction operations require the coordinator to be enabled via the relevant `CYODA_TX_*` environment variables, or must be routed to a node where the coordinator is enabled.

## SEE ALSO

- errors
- errors.TX_REQUIRED
- errors.TX_NO_STATE

## See also

- [`cyoda help errors`](/help/errors/) — Every error response from the Cyoda REST API carries a structured `errorCode` in the `properties` object. Multiple codes may share the same HTTP status. Programmatic handling keys on `errorCode`, not HTTP status.
- [`cyoda help errors TX_REQUIRED`](/help/errors/tx_required/) — Certain write operations that require atomic multi-step coordination mandate a transaction context. Returned when such an operation is called without a `transactionId` header or query parameter.
- [`cyoda help errors TX_NO_STATE`](/help/errors/tx_no_state/) — The two-phase commit coordinator tracks per-transaction state (prepared, committed, aborted). This error is returned when a commit or abort instruction references a transaction for which no state record exists, because the transaction was never prepared or was already cleaned up.

## Raw formats

- [`/help/errors/tx_coordinator_not_configured.json`](/help/errors/tx_coordinator_not_configured.json) — full descriptor (matches `GET /help/{topic}` envelope)
- [`/help/errors/tx_coordinator_not_configured.md`](/help/errors/tx_coordinator_not_configured.md) — body only