> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agent Responses

> Returns a paginated list of agent executions (responses) of the workspace, newest last unless sorted.



## OpenAPI

````yaml api-reference/tess-public-api.openapi.json GET /agent-responses
openapi: 3.0.0
info:
  title: Tess API
  version: '0.1'
servers:
  - url: https://api.tess.im
security: []
paths:
  /agent-responses:
    get:
      summary: List agent responses
      description: >-
        Returns a paginated list of agent executions (responses) of the
        workspace, newest last unless sorted.
      operationId: 9893783c89c049b5f586ee18152bab0d
      parameters:
        - name: q
          in: query
          description: Search agents by title
          schema:
            type: string
        - name: root_id
          in: query
          description: Filter by root id
          schema:
            type: integer
        - name: agent_id
          in: query
          description: Filter by agent id
          schema:
            type: integer
        - name: type
          in: query
          description: Filter by agent type
          schema:
            type: string
        - name: sort
          in: query
          description: Sort by ascending or descending
          schema:
            type: string
            default: asc
            enum:
              - asc
              - desc
        - name: page
          in: query
          description: Current page
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          description: Number of items per page
          schema:
            type: integer
            default: 15
        - name: x-workspace-id
          in: header
          description: >-
            ID of the workspace. If not provided, the user's selected workspace
            will be used.
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: The list of agent responses
        '400':
          description: The validation errors
        '403':
          description: The authentication is invalid
        '500':
          description: Unknown error
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      bearerFormat: Bearer
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.