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

# POST /v3/{+parent}/testCases

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

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDialogflowCxV3TestCase
  - `testCaseConversationTurns` GoogleCloudDialogflowCxV3ConversationTurn[]
    - `userInput` GoogleCloudDialogflowCxV3ConversationTurnUserInput
      - `input` GoogleCloudDialogflowCxV3QueryInput
        - `event` GoogleCloudDialogflowCxV3EventInput
          - `event` string
        - `audio` GoogleCloudDialogflowCxV3AudioInput
          - `config` GoogleCloudDialogflowCxV3InputAudioConfig
            - `audioEncoding` 'AUDIO_ENCODING_UNSPECIFIED' | 'AUDIO_ENCODING_LINEAR_16' | 'AUDIO_ENCODING_FLAC' | 'AUDIO_ENCODING_MULAW' | 'AUDIO_ENCODING_AMR' | 'AUDIO_ENCODING_AMR_WB' | 'AUDIO_ENCODING_OGG_OPUS' | 'AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE' | 'AUDIO_ENCODING_ALAW'
            - `sampleRateHertz` integer
            - `optOutConformerModelMigration` boolean
            - `phraseHints` string[]
            - `enableWordInfo` boolean
            - `bargeInConfig` GoogleCloudDialogflowCxV3BargeInConfig
              - …
            - `singleUtterance` boolean
            - `model` string
            - `modelVariant` 'SPEECH_MODEL_VARIANT_UNSPECIFIED' | 'USE_BEST_AVAILABLE' | 'USE_STANDARD' | 'USE_ENHANCED'
          - `audio` string, byte
        - `intent` GoogleCloudDialogflowCxV3IntentInput
          - `intent` string
        - `text` GoogleCloudDialogflowCxV3TextInput
          - `text` string
        - `dtmf` GoogleCloudDialogflowCxV3DtmfInput
          - `finishDigit` string
          - `digits` string
        - `toolCallResult` GoogleCloudDialogflowCxV3ToolCallResult
          - `outputParameters` object
          - `tool` string
          - `action` string
          - `error` GoogleCloudDialogflowCxV3ToolCallResultError
            - `message` string
        - `languageCode` string
      - `injectedParameters` object
      - `enableSentimentAnalysis` boolean
      - `isWebhookEnabled` boolean
    - `virtualAgentOutput` GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput
      - `sessionParameters` object
      - `diagnosticInfo` object
      - `triggeredIntent` GoogleCloudDialogflowCxV3Intent
        - `displayName` string
        - `labels` object
        - `parameters` GoogleCloudDialogflowCxV3IntentParameter[]
          - `entityType` string
          - `id` string
          - `redact` boolean
          - `isList` boolean
        - `name` string
        - `isFallback` boolean
        - `trainingPhrases` GoogleCloudDialogflowCxV3IntentTrainingPhrase[]
          - `id` string
          - `repeatCount` integer
          - `parts` GoogleCloudDialogflowCxV3IntentTrainingPhrasePart[]
            - `text` string
            - `parameterId` string
        - `description` string
        - `dtmfPattern` string
        - `priority` integer
      - `status` GoogleRpcStatus
        - `code` integer
        - `details` object[]
        - `message` string
      - `differences` GoogleCloudDialogflowCxV3TestRunDifference[]
        - `type` 'DIFF_TYPE_UNSPECIFIED' | 'INTENT' | 'PAGE' | 'PARAMETERS' | 'UTTERANCE' | 'FLOW'
        - `description` string
      - `textResponses` GoogleCloudDialogflowCxV3ResponseMessageText[]
        - `allowPlaybackInterruption` boolean
        - `text` string[]
      - `currentPage` GoogleCloudDialogflowCxV3Page
        - `form` GoogleCloudDialogflowCxV3Form
          - `parameters` GoogleCloudDialogflowCxV3FormParameter[]
            - `redact` boolean
            - `defaultValue` unknown
            - `entityType` string
            - `fillBehavior` GoogleCloudDialogflowCxV3FormParameterFillBehavior
              - …
            - `displayName` string
            - `required` boolean
            - `isList` boolean
            - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
              - …
        - `eventHandlers` GoogleCloudDialogflowCxV3EventHandler[]
          - `name` string
          - `event` string
          - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
            - `enableGenerativeFallback` boolean
            - `webhook` string
            - `tag` string
            - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
              - …
            - `setParameterActions` GoogleCloudDialogflowCxV3FulfillmentSetParameterAction[]
              - …
            - `returnPartialResponses` boolean
            - `generators` GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings[]
              - …
            - `conditionalCases` GoogleCloudDialogflowCxV3FulfillmentConditionalCases[]
              - …
            - `messages` GoogleCloudDialogflowCxV3ResponseMessage[]
              - …
          - `targetPlaybook` string
          - `targetPage` string
          - `targetFlow` string
        - `name` string
        - `displayName` string
        - `transitionRoutes` GoogleCloudDialogflowCxV3TransitionRoute[]
          - `name` string
          - `condition` string
          - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
            - `enableGenerativeFallback` boolean
            - `webhook` string
            - `tag` string
            - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
              - …
            - `setParameterActions` GoogleCloudDialogflowCxV3FulfillmentSetParameterAction[]
              - …
            - `returnPartialResponses` boolean
            - `generators` GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings[]
              - …
            - `conditionalCases` GoogleCloudDialogflowCxV3FulfillmentConditionalCases[]
              - …
            - `messages` GoogleCloudDialogflowCxV3ResponseMessage[]
              - …
          - `description` string
          - `intent` string
          - `targetPage` string
          - `targetFlow` string
        - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
          - `speechSettings` GoogleCloudDialogflowCxV3AdvancedSettingsSpeechSettings
            - `models` object
            - `endpointerSensitivity` integer
            - `useTimeoutBasedEndpointing` boolean
            - `noSpeechTimeout` string, google-duration
          - `loggingSettings` GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings
            - `enableInteractionLogging` boolean
            - `enableConsentBasedRedaction` boolean
            - `enableStackdriverLogging` boolean
          - `dtmfSettings` GoogleCloudDialogflowCxV3AdvancedSettingsDtmfSettings
            - `enabled` boolean
            - `maxDigits` integer
            - `finishDigit` string
            - `endpointingTimeoutDuration` string, google-duration
            - `interdigitTimeoutDuration` string, google-duration
          - `audioExportGcsDestination` GoogleCloudDialogflowCxV3GcsDestination
            - `uri` string
        - `description` string
        - `entryFulfillment` GoogleCloudDialogflowCxV3Fulfillment
          - `enableGenerativeFallback` boolean
          - `webhook` string
          - `tag` string
          - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
            - `speechSettings` GoogleCloudDialogflowCxV3AdvancedSettingsSpeechSettings
              - …
            - `loggingSettings` GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings
              - …
            - `dtmfSettings` GoogleCloudDialogflowCxV3AdvancedSettingsDtmfSettings
              - …
            - `audioExportGcsDestination` GoogleCloudDialogflowCxV3GcsDestination
              - …
          - `setParameterActions` GoogleCloudDialogflowCxV3FulfillmentSetParameterAction[]
            - `value` unknown
            - `parameter` string
          - `returnPartialResponses` boolean
          - `generators` GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings[]
            - `generator` string
            - `inputParameters` object
            - `outputParameter` string
          - `conditionalCases` GoogleCloudDialogflowCxV3FulfillmentConditionalCases[]
            - `cases` GoogleCloudDialogflowCxV3FulfillmentConditionalCasesCase[]
              - …
          - `messages` GoogleCloudDialogflowCxV3ResponseMessage[]
            - `payload` object
            - `endInteraction` GoogleCloudDialogflowCxV3ResponseMessageEndInteraction
            - `channel` string
            - `outputAudioText` GoogleCloudDialogflowCxV3ResponseMessageOutputAudioText
              - …
            - `playAudio` GoogleCloudDialogflowCxV3ResponseMessagePlayAudio
              - …
            - `mixedAudio` GoogleCloudDialogflowCxV3ResponseMessageMixedAudio
              - …
            - `responseType` 'RESPONSE_TYPE_UNSPECIFIED' | 'ENTRY_PROMPT' | 'PARAMETER_PROMPT' | 'HANDLER_PROMPT'
            - `conversationSuccess` GoogleCloudDialogflowCxV3ResponseMessageConversationSuccess
              - …
            - `liveAgentHandoff` GoogleCloudDialogflowCxV3ResponseMessageLiveAgentHandoff
              - …
            - `text` GoogleCloudDialogflowCxV3ResponseMessageText
              - …
            - `telephonyTransferCall` GoogleCloudDialogflowCxV3ResponseMessageTelephonyTransferCall
              - …
            - `knowledgeInfoCard` GoogleCloudDialogflowCxV3ResponseMessageKnowledgeInfoCard
            - `toolCall` GoogleCloudDialogflowCxV3ToolCall
              - …
        - `transitionRouteGroups` string[]
        - `knowledgeConnectorSettings` GoogleCloudDialogflowCxV3KnowledgeConnectorSettings
          - `targetPage` string
          - `dataStoreConnections` GoogleCloudDialogflowCxV3DataStoreConnection[]
            - `dataStore` string
            - `documentProcessingMode` 'DOCUMENT_PROCESSING_MODE_UNSPECIFIED' | 'DOCUMENTS' | 'CHUNKS'
            - `dataStoreType` 'DATA_STORE_TYPE_UNSPECIFIED' | 'PUBLIC_WEB' | 'UNSTRUCTURED' | 'STRUCTURED'
          - `targetFlow` string
          - `enabled` boolean
          - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
            - `enableGenerativeFallback` boolean
            - `webhook` string
            - `tag` string
            - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
              - …
            - `setParameterActions` GoogleCloudDialogflowCxV3FulfillmentSetParameterAction[]
              - …
            - `returnPartialResponses` boolean
            - `generators` GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings[]
              - …
            - `conditionalCases` GoogleCloudDialogflowCxV3FulfillmentConditionalCases[]
              - …
            - `messages` GoogleCloudDialogflowCxV3ResponseMessage[]
              - …
  - `notes` string
  - `name` string
  - `lastTestResult` GoogleCloudDialogflowCxV3TestCaseResult
    - `name` string
    - `environment` string
    - `testResult` 'TEST_RESULT_UNSPECIFIED' | 'PASSED' | 'FAILED'
    - `conversationTurns` GoogleCloudDialogflowCxV3ConversationTurn[]
      - `userInput` GoogleCloudDialogflowCxV3ConversationTurnUserInput
        - `input` GoogleCloudDialogflowCxV3QueryInput
          - `event` GoogleCloudDialogflowCxV3EventInput
            - `event` string
          - `audio` GoogleCloudDialogflowCxV3AudioInput
            - `config` GoogleCloudDialogflowCxV3InputAudioConfig
              - …
            - `audio` string, byte
          - `intent` GoogleCloudDialogflowCxV3IntentInput
            - `intent` string
          - `text` GoogleCloudDialogflowCxV3TextInput
            - `text` string
          - `dtmf` GoogleCloudDialogflowCxV3DtmfInput
            - `finishDigit` string
            - `digits` string
          - `toolCallResult` GoogleCloudDialogflowCxV3ToolCallResult
            - `outputParameters` object
            - `tool` string
            - `action` string
            - `error` GoogleCloudDialogflowCxV3ToolCallResultError
              - …
          - `languageCode` string
        - `injectedParameters` object
        - `enableSentimentAnalysis` boolean
        - `isWebhookEnabled` boolean
      - `virtualAgentOutput` GoogleCloudDialogflowCxV3ConversationTurnVirtualAgentOutput
        - `sessionParameters` object
        - `diagnosticInfo` object
        - `triggeredIntent` GoogleCloudDialogflowCxV3Intent
          - `displayName` string
          - `labels` object
          - `parameters` GoogleCloudDialogflowCxV3IntentParameter[]
            - `entityType` string
            - `id` string
            - `redact` boolean
            - `isList` boolean
          - `name` string
          - `isFallback` boolean
          - `trainingPhrases` GoogleCloudDialogflowCxV3IntentTrainingPhrase[]
            - `id` string
            - `repeatCount` integer
            - `parts` GoogleCloudDialogflowCxV3IntentTrainingPhrasePart[]
              - …
          - `description` string
          - `dtmfPattern` string
          - `priority` integer
        - `status` GoogleRpcStatus
          - `code` integer
          - `details` object[]
          - `message` string
        - `differences` GoogleCloudDialogflowCxV3TestRunDifference[]
          - `type` 'DIFF_TYPE_UNSPECIFIED' | 'INTENT' | 'PAGE' | 'PARAMETERS' | 'UTTERANCE' | 'FLOW'
          - `description` string
        - `textResponses` GoogleCloudDialogflowCxV3ResponseMessageText[]
          - `allowPlaybackInterruption` boolean
          - `text` string[]
        - `currentPage` GoogleCloudDialogflowCxV3Page
          - `form` GoogleCloudDialogflowCxV3Form
            - `parameters` GoogleCloudDialogflowCxV3FormParameter[]
              - …
          - `eventHandlers` GoogleCloudDialogflowCxV3EventHandler[]
            - `name` string
            - `event` string
            - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
              - …
            - `targetPlaybook` string
            - `targetPage` string
            - `targetFlow` string
          - `name` string
          - `displayName` string
          - `transitionRoutes` GoogleCloudDialogflowCxV3TransitionRoute[]
            - `name` string
            - `condition` string
            - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
              - …
            - `description` string
            - `intent` string
            - `targetPage` string
            - `targetFlow` string
          - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
            - `speechSettings` GoogleCloudDialogflowCxV3AdvancedSettingsSpeechSettings
              - …
            - `loggingSettings` GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings
              - …
            - `dtmfSettings` GoogleCloudDialogflowCxV3AdvancedSettingsDtmfSettings
              - …
            - `audioExportGcsDestination` GoogleCloudDialogflowCxV3GcsDestination
              - …
          - `description` string
          - `entryFulfillment` GoogleCloudDialogflowCxV3Fulfillment
            - `enableGenerativeFallback` boolean
            - `webhook` string
            - `tag` string
            - `advancedSettings` GoogleCloudDialogflowCxV3AdvancedSettings
              - …
            - `setParameterActions` GoogleCloudDialogflowCxV3FulfillmentSetParameterAction[]
              - …
            - `returnPartialResponses` boolean
            - `generators` GoogleCloudDialogflowCxV3FulfillmentGeneratorSettings[]
              - …
            - `conditionalCases` GoogleCloudDialogflowCxV3FulfillmentConditionalCases[]
              - …
            - `messages` GoogleCloudDialogflowCxV3ResponseMessage[]
              - …
          - `transitionRouteGroups` string[]
          - `knowledgeConnectorSettings` GoogleCloudDialogflowCxV3KnowledgeConnectorSettings
            - `targetPage` string
            - `dataStoreConnections` GoogleCloudDialogflowCxV3DataStoreConnection[]
              - …
            - `targetFlow` string
            - `enabled` boolean
            - `triggerFulfillment` GoogleCloudDialogflowCxV3Fulfillment
              - …
    - `testTime` string, google-datetime
  - `tags` string[]
  - `testConfig` GoogleCloudDialogflowCxV3TestConfig
    - `flow` string
    - `trackingParameters` string[]
    - `page` string
  - `displayName` string
  - `creationTime` 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)