---
url: /errors/broker_not_found.md
---
# `broker_not_found`

`broker_not_found`

## Description

The broker referenced by the authenticated broker identity does not exist.

## HTTP Status

`404 Not Found`

## `doc_url` Format

The `doc_url` value is an absolute URL and changes by environment:

`<docs-base-url>/errors/broker_not_found`

## Typical Causes

* The broker record has not been provisioned in the current environment.
* The broker was deleted after the session or access token was issued.
* The authenticated broker ID is stale or incorrect.

## How To Fix

1. Verify the broker identity in the session or access token.
2. Create or restore the broker record if it does not exist.
3. Retry the request after the broker exists.