---
title: "POST /v1/{+parent}/conversations:sample"
method: POST
path: "/v1/{+parent}/conversations:sample"
tags: ["projects"]
---

# POST /v1/{+parent}/conversations:sample

`POST /v1/{+parent}/conversations:sample`

Samples conversations based on user configuration and handles the sampled conversations for different use cases.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudContactcenterinsightsV1SampleConversationsRequest — The request to sample conversations to a dataset.
  - `destinationDataset` GoogleCloudContactcenterinsightsV1Dataset — Dataset resource represents a collection of conversations that may be bounded (Static Dataset, e.g. golden dataset for training), or unbounded (Dynamic Dataset, e.g. live traffic, or agent training traffic)
    - `type` 'TYPE_UNSPECIFIED' | 'EVAL' | 'LIVE' — Dataset usage type.
    - `description` string — Dataset description.
    - `displayName` string — Display name for the dataaset
    - `name` string — Immutable. Identifier. Resource name of the dataset. Format: projects/{project}/locations/{location}/datasets/{dataset}
    - `ttl` string, google-duration — Optional. Option TTL for the dataset.
    - `createTime` string, google-datetime — Output only. Dataset create time.
    - `updateTime` string, google-datetime — Output only. Dataset update time.
  - `parent` string — Required. The parent resource of the dataset.
  - `sampleRule` GoogleCloudContactcenterinsightsV1SampleRule — Message for sampling conversations.
    - `sampleRow` string, int64 — Number of the conversations that we should sample based on the dimension.
    - `dimension` string — Optional. Group by dimension to sample the conversation. If no dimension is provided, the sampling will be applied to the project level. Current supported dimensions is 'quality_metadata.agent_info.agent_id'.
    - `conversationFilter` string — To specify the filter for the conversions that should apply this sample rule. An empty filter means this sample rule applies to all conversations.
    - `samplePercentage` number, double — Percentage of conversations that we should sample based on the dimension between [0, 100].

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/contactcenterinsights.md) · [All operations](https://skmtc.net/google/apis/contactcenterinsights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/contactcenterinsights/versions/e071ddf4dfc3/schema)