---
title: "Create or update one or multiple entities."
method: POST
path: "/samples/push"
tags: ["Sample Controller"]
---

# Create or update one or multiple entities.

`POST /samples/push`

A uuid will be generated for any entity that doesn't have one yet. Posting entities without uuid multiple times will also create them multiple times.

## Response `207`

Array of responses, matching the posted array of entities. Provides an HTML status code for every entity and an optional body (e.g. a string with an error message).

- PostResponse[]
  - `body` object
  - `statusCode` integer

## Other responses

- `default` — When the request body has one or no entry. The status code of the response entry matches the response code and may have an optional body (e.g. a string with an error message).

## Changes

- **2026-05-28** `5c42d0fdca14` — 9 info
  - added the new `ABSCESS_SWAB` enum value to the request property `items/sampleMaterial`
  - added the new `BONE` enum value to the request property `items/sampleMaterial`
  - added the new `BONE_MARROW` enum value to the request property `items/sampleMaterial`
  - added the new `CONJUNCTIVAL_SWAB` enum value to the request property `items/sampleMaterial`
  - …5 more
- **2026-05-19** `6671fb34a0a4` — 15 info
  - added the new `ASPIRATE` enum value to the request property `items/sampleMaterial`
  - added the new `BONE_AND_JOINT` enum value to the request property `items/sampleMaterial`
  - added the new `CATHETER_EXIT_SITE` enum value to the request property `items/sampleMaterial`
  - added the new `CGMLST` enum value to the request property `items/requestedPathogenTests/items/`
  - …11 more
- **2026-05-13** `ecb25b0812f3` — 1 breaking
  - removed the enum value `PUS` of the request property `items/sampleMaterial`
- **2026-05-11** `a4d6c0ecfc78` — 1 info
  - added the new `PUS` enum value to the request property `items/sampleMaterial`
- …earlier changes not shown

[Full history](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/changes/samples/push/post.md)

---

[API](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api.md) · [All operations](https://skmtc.dev/sormas-foundation/apis/sormas-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sormas-foundation/sormas-rest-api/revisions/5c42d0fdca14/schema)