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

# List Conclusions

> List Conclusions using optional filters, ordered by recency unless `reverse` is true. Results are paginated.

Pass `cursor` (empty for the first page) to use cursor pagination, which
skips the total count and stays fast at any depth.



## OpenAPI

````yaml post /v3/workspaces/{workspace_id}/conclusions/list
openapi: 3.1.0
info:
  title: Honcho API
  summary: The Identity Layer for the Agentic World
  description: >-
    Honcho is a platform for giving agents user-centric memory and social
    cognition.
  contact:
    name: Plastic Labs
    url: https://honcho.dev/
    email: hello@plasticlabs.ai
  license:
    name: GNU Affero General Public License v3.0
    url: https://github.com/plastic-labs/honcho/blob/main/LICENSE
  version: 3.6.0
servers:
  - url: https://api.honcho.dev
    description: Production SaaS Platform
security: []
paths:
  /v3/workspaces/{workspace_id}/conclusions/list:
    post:
      tags:
        - conclusions
      summary: List Conclusions
      description: >-
        List Conclusions using optional filters, ordered by recency unless
        `reverse` is true. Results are paginated.


        Pass `cursor` (empty for the first page) to use cursor pagination, which

        skips the total count and stays fast at any depth.
      operationId: list_conclusions_v3_workspaces__workspace_id__conclusions_list_post
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            title: Workspace Id
        - name: reverse
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: Whether to reverse the order of results
            default: false
            title: Reverse
          description: Whether to reverse the order of results
        - name: page
          in: query
          required: false
          schema:
            type: integer
            maximum: 2147483647
            minimum: 1
            description: Page number (offset mode)
            default: 1
            title: Page
          description: Page number (offset mode)
        - name: size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Page size
            default: 50
            title: Size
          description: Page size
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Opt in to cursor pagination. Send an empty value for the first
              page, then the `next_page` value from each response. When set,
              `page` is ignored and the response is a cursor page with no
              `total`.
            title: Cursor
          description: >-
            Opt in to cursor pagination. Send an empty value for the first page,
            then the `next_page` value from each response. When set, `page` is
            ignored and the response is a cursor page with no `total`.
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - $ref: '#/components/schemas/ConclusionGet'
                - type: 'null'
              description: Filtering options for the Conclusions list
              title: Options
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/Page_Conclusion_'
                  - $ref: '#/components/schemas/CursorPage_Conclusion_'
                title: >-
                  Response List Conclusions V3 Workspaces  Workspace Id 
                  Conclusions List Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ConclusionGet:
      properties:
        filters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Filters
      type: object
      title: ConclusionGet
      description: Schema for listing conclusions with optional filters.
    Page_Conclusion_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/Conclusion'
          type: array
          title: Items
        total:
          type: integer
          minimum: 0
          title: Total
          description: >-
            Number of matching rows, exact up to the server's
            PAGINATION_COUNT_LIMIT (default 100000) and reported as that limit
            plus one when there are more. While a next page exists it is at
            least one more than this page's last row, so `pages` always reaches
            the end of the list.
        page:
          type: integer
          minimum: 1
          title: Page
        size:
          type: integer
          minimum: 1
          title: Size
        pages:
          type: integer
          minimum: 0
          title: Pages
      type: object
      required:
        - items
        - total
        - page
        - size
        - pages
      title: Page[Conclusion]
    CursorPage_Conclusion_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/Conclusion'
          type: array
          title: Items
        total:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total
        current_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Page
          description: Cursor to refetch the current page
        current_page_backwards:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Page Backwards
          description: Cursor to refetch the current page starting from the last item
        previous_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Previous Page
          description: Cursor for the previous page
        next_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Page
          description: Cursor for the next page
      type: object
      required:
        - items
      title: CursorPage[Conclusion]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Conclusion:
      properties:
        id:
          type: string
          title: Id
        content:
          type: string
          title: Content
        observer_id:
          type: string
          title: Observer Id
          description: The peer who made the conclusion
        observed_id:
          type: string
          title: Observed Id
          description: The peer the conclusion is about
        session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Session Id
        level:
          type: string
          enum:
            - explicit
            - deductive
            - inductive
            - contradiction
          title: Level
          description: >-
            Reasoning level of the conclusion: 'explicit' (directly extracted
            from messages) or 'deductive'/'inductive'/'contradiction' (derived
            during dreaming).
          default: explicit
        source_ids:
          items:
            type: string
          type: array
          title: Source Ids
          description: >-
            IDs of the conclusions this one was derived from: premises for
            'deductive', supporting sources for 'inductive', conflicting
            conclusions for 'contradiction'. Empty for 'explicit' conclusions,
            which derive from messages rather than from other conclusions.
        source_message_ids:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Source Message Ids
          description: >-
            IDs of the messages the deriver cited as evidence for an 'explicit'
            conclusion, in citation order. Evidence may include messages from
            peers other than the observed one. None for derived levels and for
            conclusions written before citations were recorded.
        times_derived:
          type: integer
          title: Times Derived
          description: Number of times this conclusion has been independently derived.
          default: 1
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - id
        - content
        - observer_id
        - observed_id
        - created_at
      title: Conclusion
      description: Conclusion response - external view of a document.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

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