---
title: "POST /v3/{+parent}/experiments"
method: POST
path: "/v3/{+parent}/experiments"
tags: ["projects"]
---

# POST /v3/{+parent}/experiments

`POST /v3/{+parent}/experiments`

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDialogflowCxV3Experiment
  - `description` string
  - `createTime` string, google-datetime
  - `state` 'STATE_UNSPECIFIED' | 'DRAFT' | 'RUNNING' | 'DONE' | 'ROLLOUT_FAILED'
  - `startTime` string, google-datetime
  - `rolloutFailureReason` string
  - `displayName` string
  - `rolloutConfig` GoogleCloudDialogflowCxV3RolloutConfig
    - `failureCondition` string
    - `rolloutSteps` GoogleCloudDialogflowCxV3RolloutConfigRolloutStep[]
      - `displayName` string
      - `trafficPercent` integer
      - `minDuration` string, google-duration
    - `rolloutCondition` string
  - `experimentLength` string, google-duration
  - `result` GoogleCloudDialogflowCxV3ExperimentResult
    - `versionMetrics` GoogleCloudDialogflowCxV3ExperimentResultVersionMetrics[]
      - `metrics` GoogleCloudDialogflowCxV3ExperimentResultMetric[]
        - `ratio` number, double
        - `confidenceInterval` GoogleCloudDialogflowCxV3ExperimentResultConfidenceInterval
          - `ratio` number, double
          - `lowerBound` number, double
          - `upperBound` number, double
          - `confidenceLevel` number, double
        - `type` 'METRIC_UNSPECIFIED' | 'CONTAINED_SESSION_NO_CALLBACK_RATE' | 'LIVE_AGENT_HANDOFF_RATE' | 'CALLBACK_SESSION_RATE' | 'ABANDONED_SESSION_RATE' | 'SESSION_END_RATE'
        - `count` number, double
        - `countType` 'COUNT_TYPE_UNSPECIFIED' | 'TOTAL_NO_MATCH_COUNT' | 'TOTAL_TURN_COUNT' | 'AVERAGE_TURN_COUNT'
      - `sessionCount` integer
      - `version` string
    - `lastUpdateTime` string, google-datetime
  - `rolloutState` GoogleCloudDialogflowCxV3RolloutState
    - `stepIndex` integer
    - `step` string
    - `startTime` string, google-datetime
  - `endTime` string, google-datetime
  - `name` string
  - `definition` GoogleCloudDialogflowCxV3ExperimentDefinition
    - `versionVariants` GoogleCloudDialogflowCxV3VersionVariants
      - `variants` GoogleCloudDialogflowCxV3VersionVariantsVariant[]
        - `version` string
        - `trafficAllocation` number, float
        - `isControlGroup` boolean
    - `condition` string
  - `lastUpdateTime` string, google-datetime
  - `variantsHistory` GoogleCloudDialogflowCxV3VariantsHistory[]
    - `versionVariants` GoogleCloudDialogflowCxV3VersionVariants
      - `variants` GoogleCloudDialogflowCxV3VersionVariantsVariant[]
        - `version` string
        - `trafficAllocation` number, float
        - `isControlGroup` boolean
    - `updateTime` string, google-datetime

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/dialogflow.md) · [All operations](https://skmtc.dev/google/apis/dialogflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/dialogflow/revisions/9d65e7f14110/schema)
