# methodOverride

**Kind:** Function

**Source:** [`src/middleware/method-override/index.ts`](https://github.com/honojs/hono/blob/main/src/middleware/method-override/index.ts#L60)

**Part of:** [Middleware](subsystem-src-middleware)

Method Override Middleware for Hono.

`methodOverride` is Hono middleware that changes the request method before route handling. It reads an override method from the request and dispatches the request through the supplied Hono app, allowing clients that can only send `POST` requests to reach routes such as `DELETE` or `PATCH`.

## Signature

```ts
function methodOverride(options: MethodOverrideOptions): MiddlewareHandler
```

## Parameters

| Name | Type |
|---|---|
| `options` | `MethodOverrideOptions` |

**Returns:** `MiddlewareHandler`

## Diagram

```mermaid
graph LR
  Client[Client POST request] --> Middleware[methodOverride middleware]
  Middleware --> Override[Read method override]
  Override --> App[Hono app]
  App --> Route[Route matching overridden method]
  Route --> Response[Response]
```

## Usage

```ts
import { Hono } from 'hono'
import { methodOverride } from 'hono/method-override'

const app = new Hono()

app.use('/posts/*', methodOverride({ app }))

app.delete('/posts/:id', (c) => {
  return c.text(`Deleted post ${c.req.param('id')}`)
})

// Send a POST request to:
// /posts/123?_method=DELETE
export default app
```

## AI Coding Instructions

- Pass the same `Hono` app instance to `methodOverride({ app })`.
- Mount the middleware on paths that need method override handling.
- Keep the target route declared with its actual HTTP method, such as `DELETE` or `PATCH`.
- Send an override value that matches the method expected by the target route.
- Test both the original request method and the overridden route behavior when changing middleware order.