---
title: "Create uploaded patient attachment"
method: POST
path: "/patient_attachments"
tags: ["Patient Attachment"]
---

# Create uploaded patient attachment

`POST /patient_attachments`

To create a patient attachment, you must first [generate a presigned URL](/guides/uploading_patient_attachments/), upload your file to that URL, and then supply that URL and response key in the `upload_url` request body parameter.

## Request body

- object
  - `patient_id` string, int64 — patient id
  - `description` string, nullable
  - `upload_url` string, uri — Must be a presigned URL returned by the [presigned URL upload process](/guides/uploading_patient_attachments/)
  - `filename` string, nullable

## Response `201`

Resource was created

- UploadedPatientAttachment
  - `archived_at` string, date-time, nullable
  - `category` 'audio' | 'data' | 'document' | 'image' | 'other' | 'video', nullable
  - `content` object, nullable
    - `links` object
      - `self` string, uri
  - `content_type` string, nullable
  - `created_at` string, date-time
  - `description` string, nullable
  - `filename` string, nullable
  - `id` string, int64
  - `links` object
    - `self` string, uri
  - `patient` object
    - `links` object
      - `self` string, uri
  - `pinned_at` string, date-time, nullable
  - `processed_at` string, date-time, nullable
  - `processing_completed` boolean, nullable
  - `size` string, int64, nullable
  - `updated_at` string, date-time
  - `user` object
    - `links` object
      - `self` string, uri

## Other responses

- `422` — Resource could not be saved due to validation errors

## Changes

- **2026-08-24** `9c509c169ad8` — 3 warning, 3 info
  - added the new `document` enum value to the `category` response property for the response status `201`
  - added the new `image` enum value to the `category` response property for the response status `201`
  - added the new `video` enum value to the `category` response property for the response status `201`
  - removed the `documents` enum value from the `category` response property for the response status `201`
  - …2 more
- **2026-08-11** `79f172e1968d` — 1 info
  - added the optional property `category` to the response with the `201` status

[Change history](https://skmtc.dev/cliniko/apis/cliniko-api/changes/patient_attachments/post.md)

---

[API](https://skmtc.dev/cliniko/apis/cliniko-api.md) · [All operations](https://skmtc.dev/cliniko/apis/cliniko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cliniko/cliniko-api/revisions/6eeb88a96062/schema)