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

# List an agent's conversations

> Page native Pi conversation records in the selected user or app agent instance. Native filters, IDs, and cursors apply within that one instance. The directory includes root and task-owned child conversations.



## OpenAPI

````yaml https://platform.usecontextlayer.com/api/openapi.json get /slates/{target}/agents/{name}/{actor}/conversations
openapi: 3.1.0
info:
  title: ContextLayer Platform
  version: 0.1.0
servers:
  - url: https://platform.usecontextlayer.com/api
security: []
tags:
  - name: Slates
  - name: Slate routing
  - name: Slate resources
  - name: Accounts
  - name: Shared secrets
  - name: Agents
  - name: Agent conversations
paths:
  /slates/{target}/agents/{name}/{actor}/conversations:
    get:
      tags:
        - Agent conversations
      summary: List an agent's conversations
      description: >-
        Page native Pi conversation records in the selected user or app agent
        instance. Native filters, IDs, and cursors apply within that one
        instance. The directory includes root and task-owned child
        conversations.
      operationId: listAgentConversations
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Agent directory name under agents/ in the pushed source.
          required: true
          description: Agent directory name under agents/ in the pushed source.
          name: name
          in: path
        - schema:
            anyOf:
              - type: string
                format: uuid
              - type: string
          required: true
          name: target
          in: path
        - schema:
            type: string
            enum:
              - user
              - app
            description: >-
              Required instance address: user selects the authenticated caller's
              SlateAgent; app selects this named agent's app SlateAgent. Native
              IDs and cursors belong to that instance.
          required: true
          description: >-
            Required instance address: user selects the authenticated caller's
            SlateAgent; app selects this named agent's app SlateAgent. Native
            IDs and cursors belong to that instance.
          name: actor
          in: path
        - schema:
            type: string
            enum:
              - ascending
              - descending
          required: false
          name: order
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
          required: false
          name: ownerConversationId
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
          required: false
          name: ownerTaskId
          in: query
        - schema:
            type: string
            description: >-
              JSON-encode the previous page's native next cursor without
              changing it.
          required: false
          description: >-
            JSON-encode the previous page's native next cursor without changing
            it.
          name: cursor
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
          required: true
          name: limit
          in: query
      responses:
        '200':
          description: A native Pi page of conversation records
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          exclusiveMinimum: 0
                        owner:
                          type: object
                          properties:
                            conversationId:
                              type: integer
                              exclusiveMinimum: 0
                            taskId:
                              type: integer
                              exclusiveMinimum: 0
                          required:
                            - conversationId
                            - taskId
                          additionalProperties: {}
                        parent:
                          type: object
                          properties:
                            at:
                              type: integer
                              exclusiveMinimum: 0
                            conversationId:
                              type: integer
                              exclusiveMinimum: 0
                          required:
                            - at
                            - conversationId
                          additionalProperties: {}
                      required:
                        - id
                      additionalProperties: {}
                  next:
                    type: object
                    additionalProperties: true
                    description: >-
                      Opaque native Pi scan cursor. Return it unchanged to the
                      same scan.
                required:
                  - items
        '400':
          description: Invalid slate target, agent name, actor, or scan query
        '401':
          description: A valid ContextLayer login is required
        '403':
          description: Slate viewing is forbidden or the slate is public
        '404':
          description: Slate not found
      security:
        - bearerAuth: []
        - webCookie: []
        - localWebCookie: []
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    webCookie:
      in: cookie
      name: __Secure-better-auth.session_token
      type: apiKey
    localWebCookie:
      in: cookie
      name: better-auth.session_token
      type: apiKey

````

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