---
title: "Create a request to collect and cache sample data for an Edge data source"
method: POST
path: "/samples/{assetId}/request"
tags: ["Samples"]
---

# Create a request to collect and cache sample data for an Edge data source

`POST /samples/{assetId}/request`

Creates a request to collect sample data from an Edge data source for the asset with the specified ID and temporarily makes it available in the Edge cache.

## Path parameters

- `assetId` string, uuid, required

## Response `202`

Samples were successfully requested. <br/>Returns job object which is running the fetching samples process and flag indicating if the new job was started to fetch samples or there was already one which existed before.

- RequestSamplesResponse — Represents the response returned when sample data is requested.
  - `newJob` boolean — Whether this is a newly created job or one that is in progress.
  - `job` Job
    - `id` string, uuid, required
    - `createdBy` string, uuid, required
    - `createdOn` string, date-time, required
    - `startDate` string, date-time, required
    - `endDate` string, date-time
    - `status` 'Waiting' | 'Running' | 'Completed' | 'Failed', required
    - `report` object

## Other responses

- `400` — The parameter is not a valid UUID for asset type: Column or Table.
- `401` — The client is not authenticated.
- `403` — The user lacks permission to view samples for the requested asset.
- `404` — Resource not found.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)