<div class="endpoint"><span class="method">POST</span><code>/api/v1/workspaces/&#123;workspaceId&#125;/patients/xlsx-conversions</code></div>

**Operation ID:** `patients.convertXlsx` · **Access:** PAT with `read` scope and authorized workspace where applicable · **Effect:** `read`.

Read the [patients workflow](/guides/data-model/) before this operation.

## Parameters

| Name | In | Required | Type / allowed values |
| --- | --- | --- | --- |
| `workspaceId` | path | Yes | string |

## Request body

**Content type:** `multipart/form-data` · **Required:** yes.

Schema: [XlsxUpload](/reference/schemas/xlsx-upload/). [Browse schema fields](/reference/schemas/).

## Responses

| HTTP | Content | Schema |
| --- | --- | --- |
| 200 | `text/csv` | string |
| 400 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 401 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 403 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 404 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 413 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 415 | `application/json` | [ApiError](/reference/schemas/api-error/) |
| 500 | `application/json` | [ApiError](/reference/schemas/api-error/) |

Use `error.code`, `error.issues`, and `requestId` for JSON errors. [Error and recovery guide](/guides/errors-and-retries/).