> ## 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.

# Inspect an agent conversation

> Inspect a native Pi conversation view in the selected user or app agent instance. Requires slate management permission because the view includes recent entries and internal documents, including rendered system instructions.



## OpenAPI

````yaml https://platform.usecontextlayer.com/api/openapi.json get /slates/{target}/agents/{name}/{actor}/conversations/{conversationId}
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/{conversationId}:
    get:
      tags:
        - Agent conversations
      summary: Inspect an agent conversation
      description: >-
        Inspect a native Pi conversation view in the selected user or app agent
        instance. Requires slate management permission because the view includes
        recent entries and internal documents, including rendered system
        instructions.
      operationId: getAgentConversation
      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: integer
            exclusiveMinimum: 0
          required: true
          name: conversationId
          in: path
      responses:
        '200':
          description: Native Pi conversation view with recent history and current state
          content:
            application/json:
              schema:
                type: object
                properties:
                  before:
                    type: integer
                    exclusiveMinimum: 0
                  conversation:
                    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: {}
                  docs:
                    type: object
                    additionalProperties:
                      type: object
                      properties: {}
                      additionalProperties: {}
                    description: >-
                      Native built-in conversation documents, including internal
                      execution and rendered system sections. Requires
                      inspection authorization.
                  entries:
                    type: array
                    items:
                      type: object
                      properties:
                        byTaskId:
                          type: number
                        conversationId:
                          type: number
                        data:
                          description: >-
                            Opaque native entry payload, including
                            extension-defined JSON.
                        edits:
                          type: array
                          items:
                            type: object
                            properties:
                              action:
                                type: string
                                enum:
                                  - omit
                                  - replace
                              messages:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    role:
                                      type: string
                                      enum:
                                        - system
                                        - user
                                        - assistant
                                        - toolResult
                                    timestamp:
                                      type: number
                                  required:
                                    - role
                                    - timestamp
                                  additionalProperties: {}
                                  description: >-
                                    Native Pi model message. Content, usage,
                                    tools, and provider fields pass through
                                    unchanged.
                              target:
                                type: number
                            required:
                              - action
                              - target
                            additionalProperties: {}
                        head:
                          type: number
                        id:
                          type: number
                        kind:
                          type: string
                        model:
                          type: array
                          items:
                            type: object
                            properties:
                              role:
                                type: string
                                enum:
                                  - system
                                  - user
                                  - assistant
                                  - toolResult
                              timestamp:
                                type: number
                            required:
                              - role
                              - timestamp
                            additionalProperties: {}
                            description: >-
                              Native Pi model message. Content, usage, tools,
                              and provider fields pass through unchanged.
                      required:
                        - conversationId
                        - id
                        - kind
                      additionalProperties: {}
                      description: >-
                        Native Pi EntryRecord. Model messages and extension
                        payloads pass through unchanged.
                required:
                  - conversation
                  - docs
                  - entries
                additionalProperties: {}
                description: >-
                  Native Pi ConversationView with recent entries and current
                  conversation documents.
        '400':
          description: Invalid slate target, agent name, conversation ID, or actor
        '401':
          description: A valid ContextLayer login is required
        '403':
          description: Slate management is forbidden or the slate is public
        '404':
          description: Slate or conversation 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.