- 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-platformhttps://www.googleapis.com/auth/discoveryengine.readwritehttps://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.  |