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

# POST /v3/{+parent}/versions

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

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDialogflowCxV3PlaybookVersion
  - `description` string
  - `name` string
  - `updateTime` string, google-datetime
  - `playbook` GoogleCloudDialogflowCxV3Playbook
    - `codeBlock` GoogleCloudDialogflowCxV3CodeBlock
      - `code` string
    - `referencedFlows` string[]
    - `tokenCount` string, int64
    - `name` string
    - `referencedPlaybooks` string[]
    - `outputParameterDefinitions` GoogleCloudDialogflowCxV3ParameterDefinition[]
      - `name` string
      - `typeSchema` GoogleCloudDialogflowCxV3TypeSchema
        - `inlineSchema` GoogleCloudDialogflowCxV3InlineSchema
          - `type` 'DATA_TYPE_UNSPECIFIED' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'ARRAY'
          - `items` GoogleCloudDialogflowCxV3TypeSchema — recursive
        - `schemaReference` GoogleCloudDialogflowCxV3TypeSchemaSchemaReference
          - `tool` string
          - `schema` string
      - `type` 'PARAMETER_TYPE_UNSPECIFIED' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'NULL' | 'OBJECT' | 'LIST'
      - `description` string
    - `referencedTools` string[]
    - `inlineActions` string[]
    - `llmModelSettings` GoogleCloudDialogflowCxV3LlmModelSettings
      - `promptText` string
      - `model` string
    - `displayName` string
    - `playbookType` 'PLAYBOOK_TYPE_UNSPECIFIED' | 'TASK' | 'ROUTINE'
    - `handlers` GoogleCloudDialogflowCxV3Handler[]
      - `eventHandler` GoogleCloudDialogflowCxV3HandlerEventHandler
        - `condition` string
        - `event` string
        - `fulfillment` 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
              - …
      - `lifecycleHandler` GoogleCloudDialogflowCxV3HandlerLifecycleHandler
        - `lifecycleStage` string
        - `fulfillment` 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
              - …
        - `condition` string
    - `instruction` GoogleCloudDialogflowCxV3PlaybookInstruction
      - `guidelines` string
      - `steps` GoogleCloudDialogflowCxV3PlaybookStep[]
        - `text` string
        - `steps` GoogleCloudDialogflowCxV3PlaybookStep[]
    - `goal` string
    - `updateTime` string, google-datetime
    - `inputParameterDefinitions` GoogleCloudDialogflowCxV3ParameterDefinition[]
      - `name` string
      - `typeSchema` GoogleCloudDialogflowCxV3TypeSchema
        - `inlineSchema` GoogleCloudDialogflowCxV3InlineSchema
          - `type` 'DATA_TYPE_UNSPECIFIED' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'ARRAY'
          - `items` GoogleCloudDialogflowCxV3TypeSchema — recursive
        - `schemaReference` GoogleCloudDialogflowCxV3TypeSchemaSchemaReference
          - `tool` string
          - `schema` string
      - `type` 'PARAMETER_TYPE_UNSPECIFIED' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'NULL' | 'OBJECT' | 'LIST'
      - `description` string
    - `createTime` string, google-datetime
  - `examples` GoogleCloudDialogflowCxV3Example[]
    - `displayName` string
    - `name` string
    - `tokenCount` string, int64
    - `playbookInput` GoogleCloudDialogflowCxV3PlaybookInput
      - `precedingConversationSummary` string
    - `playbookOutput` GoogleCloudDialogflowCxV3PlaybookOutput
      - `executionSummary` string
    - `languageCode` string
    - `updateTime` string, google-datetime
    - `actions` GoogleCloudDialogflowCxV3Action[]
      - `playbookInvocation` GoogleCloudDialogflowCxV3PlaybookInvocation
        - `playbookState` 'OUTPUT_STATE_UNSPECIFIED' | 'OUTPUT_STATE_OK' | 'OUTPUT_STATE_CANCELLED' | 'OUTPUT_STATE_FAILED' | 'OUTPUT_STATE_ESCALATED' | 'OUTPUT_STATE_PENDING'
        - `displayName` string
        - `playbookInput` GoogleCloudDialogflowCxV3PlaybookInput
          - `precedingConversationSummary` string
        - `playbookOutput` GoogleCloudDialogflowCxV3PlaybookOutput
          - `executionSummary` string
        - `playbook` string
      - `toolUse` GoogleCloudDialogflowCxV3ToolUse
        - `tool` string
        - `displayName` string
        - `action` string
        - `outputActionParameters` object
        - `inputActionParameters` object
      - `playbookTransition` GoogleCloudDialogflowCxV3PlaybookTransition
        - `playbook` string
        - `displayName` string
      - `flowTransition` GoogleCloudDialogflowCxV3FlowTransition
        - `displayName` string
        - `flow` string
      - `userUtterance` GoogleCloudDialogflowCxV3UserUtterance
        - `text` string
      - `agentUtterance` GoogleCloudDialogflowCxV3AgentUtterance
        - `text` string
      - `flowInvocation` GoogleCloudDialogflowCxV3FlowInvocation
        - `flow` string
        - `displayName` string
        - `flowState` 'OUTPUT_STATE_UNSPECIFIED' | 'OUTPUT_STATE_OK' | 'OUTPUT_STATE_CANCELLED' | 'OUTPUT_STATE_FAILED' | 'OUTPUT_STATE_ESCALATED' | 'OUTPUT_STATE_PENDING'
    - `conversationState` 'OUTPUT_STATE_UNSPECIFIED' | 'OUTPUT_STATE_OK' | 'OUTPUT_STATE_CANCELLED' | 'OUTPUT_STATE_FAILED' | 'OUTPUT_STATE_ESCALATED' | 'OUTPUT_STATE_PENDING'
    - `createTime` string, google-datetime
    - `description` string

## 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)