If the specified session entity type already exists, overrides the session entity type.
This method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.
HTTP request
POST https://{endpoint}/v2beta1/{parent=projects/*/agent/sessions/*}/entityTypes
Required. The session to create a session entity type for. Supported formats: - projects/<Project ID>/agent/sessions/<Session ID>,
-projects//locations//agent/sessions/,
-projects//agent/environments//users//sessions/,
-projects//locations//agent/environments//users//sessions/`,
If Location ID is not specified we assume default 'us' location. If Environment ID is not specified, we assume default 'draft' environment. If User ID is not specified, we assume default '-' user.
Authorization requires the following IAM permission on the specified resource parent:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis endpoint creates or overrides a session entity type within a specified Dialogflow session.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a POST method to a specific URL structure, including placeholders for the endpoint and session details.\u003c/p\u003e\n"],["\u003cp\u003eThe parent path parameter is required and specifies the session for which the entity type will be created, with default values if location, environment, or user IDs are not explicitly stated.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eSessionEntityType\u003c/code\u003e instance, and the successful response will return a newly created \u003ccode\u003eSessionEntityType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eCreating a session entity type requires specific IAM permission (\u003ccode\u003edialogflow.sessionEntityTypes.create\u003c/code\u003e) and either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.sessions.entityTypes.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a session entity type.\n\nIf the specified session entity type already exists, overrides the session entity type.\n\nThis method doesn't work with Google Assistant integration. Contact Dialogflow support if you need to use session entities with Google Assistant integration.\n\n### HTTP request\n\n`POST https://{endpoint}/v2beta1/{parent=projects/*/agent/sessions/*}/entityTypes`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2beta1/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SessionEntityType](/dialogflow/es/docs/reference/rest/v2beta1/projects.agent.environments.users.sessions.entityTypes#SessionEntityType).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
