- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- FileSelection
Selects context files to be used in a session.
HTTP request
POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}:selectContextFiles
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
| name | 
 Required. The name of the session. Format:  | 
Request body
The request body contains data with the following structure:
| JSON representation | 
|---|
| {
  "fileSelections": [
    {
      object ( | 
| Fields | |
|---|---|
| fileSelections[] | 
 Required. File selection changes. Only files previously uploaded to the session can be selected (or deselected). Files not mentioned here will keep their current selection status. | 
Response body
If successful, the response body is empty.
Authorization scopes
Requires one of the following OAuth scopes:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/discoveryengine.readwrite
- https://www.googleapis.com/auth/discoveryengine.assist.readwrite
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the name resource:
- discoveryengine.sessions.selectContextFiles
For more information, see the IAM documentation.
FileSelection
The selection status of a context file.
| JSON representation | 
|---|
| { "fileId": string, "selected": boolean } | 
| Fields | |
|---|---|
| fileId | 
 Required. The ID of the context file. | 
| selected | 
 Required. Whether the file is selected to be used in the session. |