---
title: "Upload Modality"
method: POST
path: "/modalities/upload"
tags: ["modalities"]
---

# Upload Modality

`POST /modalities/upload`

## Request

- Base URL: `https://api.alpha-grid.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.alpha-grid.ai/modalities/upload`
- Auth: HTTP bearer

Handle local uploads for modality assets.

## Request body `multipart/form-data`

- BodyUploadModalityModalitiesUploadPost
  - `patient_id` integer, required: Patient identifier
  - `modality_type` string, required: Modality category
  - `title` string, nullable
  - `recorded_on` string, nullable
  - `description` string, nullable
  - `priority` string, nullable
  - `category` string, nullable
  - `sample_url` string, nullable
  - `files` string[], nullable

## Response `201`

Successful Response

- ModalityOut
  - `id` integer, required
  - `organization_id` integer, required
  - `branch_id` integer, required
  - `patient_id` integer, required
  - `patient_visit_id` integer, nullable
  - `type` string, required
  - `title` string, required
  - `description` string, nullable
  - `report_text` string, nullable
  - `details` object
  - `summary` string, nullable
  - `file_url` string, nullable
  - `assets` ModalityAssetOut[]
    - `id` integer, required
    - `file_url` string, required
    - `file_name` string, nullable, required
    - `file_type` string, nullable, required
    - `file_size` integer, nullable, required
    - `checksum` string, nullable, required
    - `storage_provider` string, nullable, required
    - `metadata` object
    - `created_at` string, date-time, required
  - `status` string, required
  - `document_date` string, date, nullable
  - `recorded_on` string, nullable
  - `extraction_confidence` number, nullable
  - `is_final` boolean
  - `created_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/alpha-grid/apis/alphagrid-backend-dev.md) - [All operations](https://skmtc.dev/alpha-grid/apis/alphagrid-backend-dev/llms.txt) - [OpenAPI document](https://skmtc.dev/alpha-grid/apis/alphagrid-backend-dev/revisions/13bab0bdd466?raw)