List sessions

Get a list of all Cognitio sessions across projects, sorted by most recently updated. Archived sessions are excluded by default.

GET /experimental/session

JavaScript

JavaScript

import { createCognitioClient } from "@cognitio/sdk

const client = createCognitioClient()
await client.experimental.session.list({
  ...
})

200

[
  {
    "id": "<string>",
    "slug": "<string>",
    "projectID": "<string>",
    "directory": "<string>",
    "title": "<string>",
    "version": "<string>",
    "time": {
      "created": 123,
      "updated": 123,
      "compacting": 123,
      "archived": 123
    },
    "project": {
      "id": "<string>",
      "worktree": "<string>",
      "name": "<string>"
    },
    "workspaceID": "<string>",
    "parentID": "<string>",
    "forkedFrom": "<string>",
    "summary": {
      "additions": 123,
      "deletions": 123,
      "files": 123,
      "diffs": [
        {
          "file": "<string>",
          "patch": "<string>",
          "additions": 123,
          "deletions": 123,
          "status": "added"
        }
      ]
    },
    "share": {
      "url": "<string>"
    },
    "tags": [],
    "permission": [
      {
        "permission": "<string>",
        "pattern": "<string>",
        "action": "allow"
      }
    ],
    "revert": {
      "messageID": "<string>",
      "partID": "<string>",
      "snapshot": "<string>",
      "checkpointId": "<string>",
      "diff": "<string>"
    }
  }
]

Query Parameters

directory · string

Filter sessions by project directory

workspace · string

roots · boolean

Only return root sessions (no parentID)

start · number

Filter sessions updated on or after this timestamp (milliseconds since epoch)

cursor · number

Return sessions updated before this timestamp (milliseconds since epoch)

search · string

Filter sessions by title (case-insensitive)

tag · string

Filter sessions by exact tag

limit · number

Maximum number of sessions to return

archived · boolean

Include archived sessions (default false)

Response

200 - application/json

List of sessions

id · string · required

Pattern: ^ses.*

slug · string · required

projectID · string · required

directory · string · required

title · string · required

version · string · required

time · object · required

Show child attributes

project · object | null · required

Show child attributes

workspaceID · string

Pattern: ^wrk.*

parentID · string

Pattern: ^ses.*

forkedFrom · string

Pattern: ^ses.*

summary · object

Show child attributes

share · object

Show child attributes

tags · string[]

permission · object[]

Show child attributes

revert · object

Show child attributes