:doc:`BedrockAgentCore <../../bedrock-agentcore>` / Client / list_sessions

*************
list_sessions
*************



.. py:method:: BedrockAgentCore.Client.list_sessions(**kwargs)

  

  Lists sessions in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully.

   

  To use this operation, you must have the ``bedrock-agentcore:ListSessions`` permission.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ListSessions>`_  


  **Request Syntax**
  ::

    response = client.list_sessions(
        memoryId='string',
        actorId='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type memoryId: string
  :param memoryId: **[REQUIRED]** 

    The identifier of the AgentCore Memory resource for which to list sessions.

    

  
  :type actorId: string
  :param actorId: **[REQUIRED]** 

    The identifier of the actor for which to list sessions.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to return in a single call. The default value is 20.

    

  
  :type nextToken: string
  :param nextToken: 

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'sessionSummaries': [
              {
                  'sessionId': 'string',
                  'actorId': 'string',
                  'createdAt': datetime(2015, 1, 1)
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **sessionSummaries** *(list) --* 

        The list of session summaries that match the specified criteria.

        
        

        - *(dict) --* 

          Contains summary information about a session in an AgentCore Memory resource.

          
          

          - **sessionId** *(string) --* 

            The unique identifier of the session.

            
          

          - **actorId** *(string) --* 

            The identifier of the actor associated with the session.

            
          

          - **createdAt** *(datetime) --* 

            The timestamp when the session was created.

            
      
    
      

      - **nextToken** *(string) --* 

        The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.

        
  
  **Exceptions**
  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ThrottledException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ValidationException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.InvalidInputException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ResourceNotFoundException`

  