---
title: "Upload a sample file"
method: POST
path: "/v2/quality/samples/{sampleName}"
tags: ["Quality Samples"]
---

# Upload a sample file

`POST /v2/quality/samples/{sampleName}`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v2/quality/samples/{sampleName}`
- Auth: HTTP bearer

Persists raw delimited file content as a named sample for a given asset. Returns the created SampleFileModel with field metadata and row count.

## Path parameters

- `sampleName` string, required

## Query parameters

- `assetTypePath` string
- `assetNamePath` string

## Response `201`

Sample successfully created

- SampleFileView
  - `assetNamePath` string
  - `assetTypePath` string
  - `createdDate` string, date-time
  - `daysLeftToPurge` integer
  - `fields` SampleFileFieldView[]
    - `name` string
    - `semanticType` string
    - `type` string
  - `fileConfigurationModel` SampleFileConfigView
    - `delimiter` string
    - `encoding` string
    - `lineSeparator` string
    - `textQualifier` string
  - `lastModifiedDate` string, date-time
  - `name` string
  - `numberOfRows` integer
  - `sampleStorageProvider` string
  - `sampleType` string
  - `tags` string[]

## Other responses

- `400`: Invalid request parameters
- `500`: Internal server error

---

[API](https://skmtc.dev/precisely/apis/verify-api-portal.md) · [All operations](https://skmtc.dev/precisely/apis/verify-api-portal/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/verify-api-portal/revisions/380735465266?raw)