---
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-06-01** `db5bb6e87739` — 26 info
  - added the new `ACID_FAST_STAIN` enum value to the request property `items/requestedPathogenTests/items/`
  - added the new `BACTERIAL_CULTURE` enum value to the request property `items/requestedPathogenTests/items/`
  - added the new `CRISPR_DIAGNOSTICS` enum value to the request property `items/requestedPathogenTests/items/`
  - added the new `DARK_FIELD_MICROSCOPY` enum value to the request property `items/requestedPathogenTests/items/`
  - …22 more
- **2026-06-01** `df8c4384cec2` — 4 info
  - added the new `CORD_BLOOD` enum value to the request property `items/sampleMaterial`
  - added the new `LUNG_TISSUE` enum value to the request property `items/sampleMaterial`
  - added the new `PLACENTA` enum value to the request property `items/sampleMaterial`
  - added the new `ULCER_SWAB` enum value to the request property `items/sampleMaterial`
- **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
- …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/be74155f01cb/schema)