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

# POST /v3/{+parent}/tools

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

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDialogflowCxV3Tool
  - `name` string
  - `description` string
  - `dataStoreSpec` GoogleCloudDialogflowCxV3ToolDataStoreTool
    - `dataStoreConnections` GoogleCloudDialogflowCxV3DataStoreConnection[]
      - `dataStore` string
      - `documentProcessingMode` 'DOCUMENT_PROCESSING_MODE_UNSPECIFIED' | 'DOCUMENTS' | 'CHUNKS'
      - `dataStoreType` 'DATA_STORE_TYPE_UNSPECIFIED' | 'PUBLIC_WEB' | 'UNSTRUCTURED' | 'STRUCTURED'
    - `fallbackPrompt` GoogleCloudDialogflowCxV3ToolDataStoreToolFallbackPrompt
  - `toolType` 'TOOL_TYPE_UNSPECIFIED' | 'CUSTOMIZED_TOOL' | 'BUILTIN_TOOL'
  - `openApiSpec` GoogleCloudDialogflowCxV3ToolOpenApiTool
    - `textSchema` string
    - `tlsConfig` GoogleCloudDialogflowCxV3ToolTLSConfig
      - `caCerts` GoogleCloudDialogflowCxV3ToolTLSConfigCACert[]
        - `cert` string, byte
        - `displayName` string
    - `authentication` GoogleCloudDialogflowCxV3ToolAuthentication
      - `apiKeyConfig` GoogleCloudDialogflowCxV3ToolAuthenticationApiKeyConfig
        - `apiKey` string
        - `keyName` string
        - `secretVersionForApiKey` string
        - `requestLocation` 'REQUEST_LOCATION_UNSPECIFIED' | 'HEADER' | 'QUERY_STRING'
      - `oauthConfig` GoogleCloudDialogflowCxV3ToolAuthenticationOAuthConfig
        - `clientSecret` string
        - `oauthGrantType` 'OAUTH_GRANT_TYPE_UNSPECIFIED' | 'CLIENT_CREDENTIAL'
        - `clientId` string
        - `secretVersionForClientSecret` string
        - `tokenEndpoint` string
        - `scopes` string[]
      - `serviceAgentAuthConfig` GoogleCloudDialogflowCxV3ToolAuthenticationServiceAgentAuthConfig
        - `serviceAgentAuth` 'SERVICE_AGENT_AUTH_UNSPECIFIED' | 'ID_TOKEN' | 'ACCESS_TOKEN'
      - `serviceAccountAuthConfig` GoogleCloudDialogflowCxV3ToolAuthenticationServiceAccountAuthConfig
        - `serviceAccount` string
      - `bearerTokenConfig` GoogleCloudDialogflowCxV3ToolAuthenticationBearerTokenConfig
        - `secretVersionForToken` string
        - `token` string
    - `serviceDirectoryConfig` GoogleCloudDialogflowCxV3ToolServiceDirectoryConfig
      - `service` string
  - `functionSpec` GoogleCloudDialogflowCxV3ToolFunctionTool
    - `inputSchema` object
    - `outputSchema` object
  - `displayName` 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)