---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/ConvertRequest.md
description: 'A format-changing request handed to a [`ConvertCapability`](https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/ConvertCapability).'
---

# Interface: ConvertRequest

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

A format-changing request handed to a [ConvertCapability](ConvertCapability.md).

## Properties

| Property                                  | Type                                  | Description                                                            | Defined in                                                                                                                        |
| ----------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|  `bytes`       | `Uint8Array`                          | The input content bytes.                                               | [src/batteries/media/contracts.ts:253](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L253) |
|  `filename` | `string`                              | The input filename (extension informs format sniffing).                | [src/batteries/media/contracts.ts:257](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L257) |
|  `mimeType` | `string`                              | The input MIME type.                                                   | [src/batteries/media/contracts.ts:255](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L255) |
|  `options?`  | [`ConvertOptions`](ConvertOptions.md) | Capability-specific options — see [ConvertOptions](ConvertOptions.md). | [src/batteries/media/contracts.ts:261](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L261) |
|  `signal?`    | `AbortSignal`                         | Abort signal threaded from the pipeline execution.                     | [src/batteries/media/contracts.ts:263](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L263) |
|  `to`             | `string`                              | The target format token (`pdf`, `docx`, `txt`, `pcm`, `images`, …).    | [src/batteries/media/contracts.ts:259](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L259) |