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

# GET /api/rooms/{roomId}/sessions/{sessionId}/messages

> One ended session's ledger rows, newest first, paged like `/messages`.



## OpenAPI

````yaml /api/worksong.openapi.json get /api/rooms/{roomId}/sessions/{sessionId}/messages
openapi: 3.1.0
info:
  title: Worksong API
  version: 042e65d5f227
  description: >-
    The HTTP API behind the Worksong apps, generated from the code at the commit
    below. Request and response shapes come from the shared zod contract; an
    operation marked `x-gaps` has a part the generator could not resolve.
  x-source: worksong-ai/worksong@042e65d5f2275493f60f879c7970dcfdeceb7e0e
servers:
  - url: https://app.worksong.ai
security:
  - bearerAuth: []
tags:
  - name: Approvals
  - name: Audit
  - name: Avatar generator
  - name: Bootstrap
  - name: Bot compute limit
  - name: Bot mcp servers
  - name: Bots
  - name: Calls
  - name: Connections
  - name: Contacts
  - name: Conversations
  - name: Coupons
  - name: Day grants
  - name: Desktop
  - name: Entity files
  - name: Files
  - name: Github
  - name: Insights
  - name: Login
  - name: Mcp servers
  - name: Me
  - name: Me bot messaging
  - name: Me chat header
  - name: Me daily limit
  - name: Me time zone
  - name: Memory
  - name: Message delete
  - name: Messages
  - name: Notifications
  - name: Optimize prompt
  - name: Phone
  - name: Places
  - name: Projects
  - name: Public file links
  - name: Push
  - name: Queue
  - name: Reactions
  - name: Register
  - name: Rooms
  - name: Routes
  - name: Routines
  - name: Runs
  - name: Skills
  - name: Tasks
  - name: Transcribe
  - name: Tts
  - name: Webhooks
  - name: Whats new
  - name: Whatsapp
  - name: Workspace files
paths:
  /api/rooms/{roomId}/sessions/{sessionId}/messages:
    get:
      tags:
        - Rooms
      summary: GET /api/rooms/{roomId}/sessions/{sessionId}/messages
      description: One ended session's ledger rows, newest first, paged like `/messages`.
      operationId: get_api_rooms_roomId_sessions_sessionId_messages
      parameters:
        - name: roomId
          in: path
          required: true
          schema:
            type: string
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            default: 50
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 512
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        roomId:
                          type: string
                          format: uuid
                        seq:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        authorKind:
                          type: string
                          enum:
                            - user
                            - bot
                        botId:
                          anyOf:
                            - type: string
                              format: uuid
                            - type: 'null'
                        botName:
                          anyOf:
                            - type: string
                              maxLength: 80
                            - type: 'null'
                        text:
                          type: string
                          minLength: 1
                          maxLength: 100000
                        runId:
                          anyOf:
                            - type: string
                              format: uuid
                            - type: 'null'
                        createdAt:
                          type: string
                          format: date-time
                        reactions:
                          type: array
                          items:
                            type: object
                            properties:
                              emoji:
                                type: string
                                minLength: 1
                                maxLength: 32
                              count:
                                type: integer
                                exclusiveMinimum: 0
                                maximum: 9007199254740991
                              mine:
                                type: boolean
                            required:
                              - emoji
                              - count
                              - mine
                            additionalProperties: false
                        attachments:
                          maxItems: 16
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                minLength: 1
                                maxLength: 255
                              mediaType:
                                type: string
                                minLength: 1
                                maxLength: 128
                              sizeBytes:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              url:
                                type: string
                                minLength: 1
                                maxLength: 2048
                              file:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    format: uuid
                                  filename:
                                    type: string
                                    minLength: 1
                                    maxLength: 255
                                  mimeType:
                                    type: string
                                    minLength: 1
                                    maxLength: 128
                                  byteSize:
                                    type: integer
                                    minimum: 0
                                    maximum: 9007199254740991
                                  available:
                                    type: boolean
                                  createdAt:
                                    type: string
                                    format: date-time
                                  origin:
                                    default: upload
                                    type: string
                                    enum:
                                      - upload
                                      - agent
                                  sha256:
                                    default: null
                                    anyOf:
                                      - type: string
                                        pattern: ^[0-9a-f]{64}$
                                      - type: 'null'
                                required:
                                  - id
                                  - filename
                                  - mimeType
                                  - byteSize
                                  - available
                                  - createdAt
                                  - origin
                                  - sha256
                                additionalProperties: false
                            required:
                              - name
                              - mediaType
                              - sizeBytes
                              - url
                            additionalProperties: false
                      required:
                        - id
                        - roomId
                        - seq
                        - authorKind
                        - botId
                        - botName
                        - text
                        - runId
                        - createdAt
                      additionalProperties: false
                  nextCursor:
                    anyOf:
                      - type: string
                        minLength: 1
                        maxLength: 512
                      - type: 'null'
                required:
                  - items
                  - nextCursor
                additionalProperties: false
        4XX:
          description: Error. A problem object with a status and a message.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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