---
title: "Create Sample Unit for sample summary"
method: POST
path: "/samples/{samplesummaryId}/sampleunits"
tags: ["samples"]
---

# Create Sample Unit for sample summary

`POST /samples/{samplesummaryId}/sampleunits`

## Request

- Base URL: `http://localhost:8125`
- URL: `http://localhost:8125/samples/{samplesummaryId}/sampleunits`
- Auth: HTTP basic

Create Sample Unit for sample summary

## Path parameters

- `samplesummaryId` string, uuid, required

## Request body

- SampleUnit
  - `formType` string
  - `id` string, uuid
  - `sampleSummaryFK` integer
  - `sampleUnitPK` integer
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `status` 'INIT' | 'DELIVERED' | 'PERSISTED' | 'FAILED'

## Response `200`

The sample unit was created successfully.

- SampleUnit[]
  - `formType` string
  - `id` string, uuid
  - `sampleSummaryFK` integer
  - `sampleUnitPK` integer
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `status` 'INIT' | 'DELIVERED' | 'PERSISTED' | 'FAILED'

## Other responses

- `400`: No sample unit found for sample summary.
- `401`: Authentication information is missing or invalid.
- `409`: Sample already exists for the sample summary with that sampleUnitRef
- `500`: #/components/responses/ServerError

## Changes

- **2021-09-30** `fc3fec3be47e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/changes/samples/:samplesummaryId/sampleunits/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/revisions/6236ad7256ad?raw)