---
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-07-10** `d5e6aa922448` — 6 breaking
  - removed the enum value `ANTIGEN_DETECTION` of the request property `items/requestedPathogenTests/items/`
  - removed the enum value `DIRECT_MICROSCOPY` of the request property `items/requestedPathogenTests/items/`
  - removed the enum value `RAPID_ANTIBODY_TEST` of the request property `items/requestedPathogenTests/items/`
  - removed the enum value `RAPID_ANTIGEN_DETECTION` of the request property `items/requestedPathogenTests/items/`
  - …2 more
- **2026-06-30** `eb4c91f188eb` — 1 info
  - added the new `RSV_SUBTYPING` enum value to the request property `items/requestedPathogenTests/items/`
- **2026-06-26** `87a3ff316b71` — 2 warning
  - removed the request property `items/performedByReferenceLaboratory`
  - removed the request property `items/retestRequested`
- **2026-06-19** `07a68b56826c` — 1 info
  - added the new `DIRECT_MICROSCOPY` enum value to the request property `items/requestedPathogenTests/items/`
- **2026-06-15** `a01e2ab6857d` — 2 info
  - added the new optional request property `items/performedByReferenceLaboratory`
  - added the new optional request property `items/retestRequested`

[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/2fcf2b3dfea9/schema)