---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/MutateRequest.md
description: >-
  A same-format content transform handed to a [`MutateCapability`](https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/MutateCapability) — the
  fused image request: adjacent `image.*` steps fold into ONE request so a
  resize→rotate→format chain costs a single decode/encode.
---

# Interface: MutateRequest

Defined in: [src/batteries/media/contracts.ts:310](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L310)

A same-format content transform handed to a [MutateCapability](MutateCapability.md) — the fused image
request: adjacent `image.*` steps fold into ONE request so a resize→rotate→format chain
costs a single decode/encode.

## Properties

| Property                                             | Type                                                                                                                      | Description                                                   | Defined in                                                                                                                        |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|  `bytes`                  | `Uint8Array`                                                                                                              | The input bytes.                                              | [src/batteries/media/contracts.ts:312](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L312) |
|  `flip?`                   | { `horizontal?`: `boolean`; `vertical?`: `boolean`; }                                                                   | Flip axes.                                                    | [src/batteries/media/contracts.ts:324](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L324) |
| `flip.horizontal?`                                   | `boolean`                                                                                                                 | -                                                             | [src/batteries/media/contracts.ts:324](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L324) |
| `flip.vertical?`                                     | `boolean`                                                                                                                 | -                                                             | [src/batteries/media/contracts.ts:324](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L324) |
|  `format?`               | { `quality?`: `number`; `to`: `string`; }                                                                               | Re-encode target, when requested (rides the same fused call). | [src/batteries/media/contracts.ts:328](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L328) |
| `format.quality?`                                    | `number`                                                                                                                  | -                                                             | [src/batteries/media/contracts.ts:328](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L328) |
| `format.to`                                          | `string`                                                                                                                  | -                                                             | [src/batteries/media/contracts.ts:328](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L328) |
|  `mimeType`            | `string`                                                                                                                  | The input MIME type.                                          | [src/batteries/media/contracts.ts:314](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L314) |
|  `resize?`               | { `fit?`: `"fill"` | `"cover"` | `"contain"` | `"inside"` | `"outside"`; `height?`: `number`; `width?`: `number`; } | Resize, when requested.                                       | [src/batteries/media/contracts.ts:316](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L316) |
| `resize.fit?`                                        | `"fill"` | `"cover"` | `"contain"` | `"inside"` | `"outside"`                                                         | -                                                             | [src/batteries/media/contracts.ts:319](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L319) |
| `resize.height?`                                     | `number`                                                                                                                  | -                                                             | [src/batteries/media/contracts.ts:318](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L318) |
| `resize.width?`                                      | `number`                                                                                                                  | -                                                             | [src/batteries/media/contracts.ts:317](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L317) |
|  `rotate?`               | `90` | `180` | `270`                                                                                                    | Clockwise rotation in degrees.                                | [src/batteries/media/contracts.ts:322](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L322) |
|  `signal?`               | `AbortSignal`                                                                                                             | Abort signal threaded from the pipeline execution.            | [src/batteries/media/contracts.ts:330](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L330) |
|  `stripMetadata?` | `boolean`                                                                                                                 | Remove EXIF/ICC metadata.                                     | [src/batteries/media/contracts.ts:326](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L326) |