Get session

Retrieve a session by ID.

GET/api/session/{sessionID}

Path parameters

sessionIDobjectrequired

Responses

200Success

dataSession.Inforequired

Show properties

idobjectrequired

Show properties

object

parentIDobject

Show properties

object

forkobject

Show properties

sessionIDobjectrequired

Show properties

object

messageIDobject

Show properties

object

projectIDstringrequired

agentstring

modelModel.Ref

Show properties

idstringrequired

providerIDstringrequired

variantstring

costMoney.USDrequired

tokensTokenUsage.Inforequired

Show properties

inputnumberrequired

outputnumberrequired

reasoningnumberrequired

cacheobjectrequired

Show properties

readnumberrequired

writenumberrequired

timeobjectrequired

Show properties

creatednumberrequired

updatednumberrequired

archivednumber

titlestringrequired

locationLocation.Refrequired

Show properties

directorystringrequired

workspaceIDobject

Show properties

object

subpathstring

revertSession.Revert

Show properties

messageIDobjectrequired

Show properties

object

partIDstring

snapshotstring

filesFileDiff.Info[]

Show properties

Array of FileDiff.Info

filestringrequired

patchstringrequired

additionsobjectrequired

Show properties

object

deletionsobjectrequired

Show properties

object

statusstringrequired

Allowed:addeddeletedmodified

400InvalidRequestError

_tagstringrequired

Allowed:InvalidRequestError

messagestringrequired

kindstring | any

Show properties

Any of:

string

string

any

any

fieldstring | any

Show properties

Any of:

string

string

any

any

401UnauthorizedError

_tagstringrequired

Allowed:UnauthorizedError

messagestringrequired

404SessionNotFoundError

Any of:

SessionNotFoundError

_tagstringrequired

Allowed:SessionNotFoundError

sessionIDstringrequired

messagestringrequired

SessionNotFoundError

_tagstringrequired

Allowed:SessionNotFoundError

sessionIDstringrequired

messagestringrequired

Request

curl -X GET "/api/session/%5Bobject%20Object%5D"

const response = await fetch("/api/session/%5Bobject%20Object%5D", {
  method: "GET"
});

import requests

response = requests.get(
    "/api/session/%5Bobject%20Object%5D",
)

Response

{
  "data": {
    "id": {},
    "parentID": {},
    "fork": {
      "sessionID": {},
      "messageID": {}
    },
    "projectID": "string",
    "agent": "string",
    "model": {
      "id": "string",
      "providerID": "string",
      "variant": "string"
    },
    "cost": 0,
    "tokens": {
      "input": 0,
      "output": 0,
      "reasoning": 0,
      "cache": {
        "read": 0,
        "write": 0
      }
    },
    "time": {
      "created": 0,
      "updated": 0,
      "archived": 0
    },
    "title": "string",
    "location": {
      "directory": "string",
      "workspaceID": {}
    },
    "subpath": "string",
    "revert": {
      "messageID": {},
      "partID": "string",
      "snapshot": "string",
      "files": [
        {
          "file": "string",
          "patch": "string",
          "additions": {},
          "deletions": {},
          "status": "added"
        }
      ]
    }
  }
}