> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

## Business Verification / API

### Fixed the submitted address key in business creation examples

Address lines on `POST /v1/businesses` are `address_line1` and `address_line2`. Some examples and the request schema showed `address_line_1` and `address_line_2`, which the API ignores, so an address submitted with the underscored keys was accepted without its street lines. Check any integration built from those examples and send `address_line1` and `address_line2`. [View the connections guide](/verify-business/discover-connections).

## Credit Risk / API

### Added a terminal `failed` status to liens

A lien filing that a state rejects and Middesk does not resubmit ends in `status: failed` with `status_category: failed`. `failed` is terminal, so a lien in this state does not move on to `filed`, `open`, or `closed`. Integrations that branch on lien `status` or `status_category` should tolerate the new value and treat it as an end state. [View the Lien object reference](/reference/lien).

## Agents / API

### Added `business_id` to agent runs and run webhook events

The Run object includes a nullable `business_id` identifying the Middesk business a run is scoped to. It is returned by `GET /v1/runs` and `GET /v1/runs/{id}` and included in the `run.created`, `run.interrupted`, and `run.completed` webhook payloads, so a consumer no longer needs to keep its own thread-to-business mapping. Run events also send an `X-Correlation-ID` header using the business `external_id` when set and the Middesk business id otherwise, matching the `business.updated` convention. `business_id` is `null` on `run.created` when a run starts with an inline `business` payload for a business that does not exist yet; later events for that run carry the id. The field is additive and nullable, so existing consumers need no changes. [View the Run object reference](/reference/run) and [agent webhook events](/work-with-agents/webhooks).