Get session messages

Retrieve all messages in a session, including user prompts and AI responses.

GET /session/{sessionID}/message

JavaScript

JavaScript

import { createCognitioClient } from "@cognitio/sdk

const client = createCognitioClient()
await client.session.messages({
  ...
})

200

[
  {
    "info": {
      "id": "<string>",
      "sessionID": "<string>",
      "role": "user",
      "time": {
        "created": 123
      },
      "agent": "<string>",
      "model": {
        "providerID": "<string>",
        "modelID": "<string>",
        "variant": "<string>"
      },
      "parentMessageID": "<string>",
      "format": {
        "type": "text"
      },
      "summary": {
        "diffs": [
          {
            "file": "<string>",
            "patch": "<string>",
            "additions": 123,
            "deletions": 123,
            "status": "added"
          }
        ],
        "title": "<string>",
        "body": "<string>"
      },
      "system": "<string>",
      "tools": {}
    },
    "parts": [
      {
        "id": "<string>",
        "sessionID": "<string>",
        "messageID": "<string>",
        "type": "text",
        "text": "<string>",
        "synthetic": true,
        "ignored": true,
        "time": {
          "start": 123,
          "end": 123
        },
        "metadata": {}
      }
    ]
  }
]

Path Parameters

sessionID · string · required

Pattern: ^ses.*

Query Parameters

directory · string

workspace · string

limit · integer

Maximum number of messages to return

Required range: 0 <= x <= 9007199254740991

before · string

view · enum<string>

Transcript view to return

Available options: raw, active

Response

200

application/json

List of messages

info · object · required

Option 1

Option 2

Show child attributes

parts · object[] · required

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Show child attributes