List sessions

Returns sessions in the workspace, newest first. userId and userDisplayName identify the user who recorded each session. Requires the torqee:sessions:read scope.

GET/api/v1/sessions

Authorization

AuthorizationOAuth2 access token · headerrequired

OAuth 2.1 authorization code flow with PKCE. Audience must be the connect URL.

Scopes:torqee:sessions:read

AuthorizationBearer token · headerrequired

Workspace API key issued from the torqee web app. Pass the torqee_-prefixed key as the bearer token. API keys carry the same read scopes as OAuth tokens.

Query parameters

cursorstring

min length 1

limitinteger

min 1 · max 100

Responses

200

Paginated session summaries

itemsobject[]required

Show properties

Array of object

idstringrequired

userIdstringrequired

userDisplayNamestring | nullrequired

labelstring | nullrequired

memostring | nullrequired

statusstringrequired

startedAtstring | nullrequired

endedAtstring | nullrequired

createdAtstringrequired

updatedAtstringrequired

nextCursorstring | nullrequired

400

Invalid pagination parameters

errorstringrequired

Allowed:invalid_request

401

Missing or invalid credentials

errorstringrequired

Allowed:unauthorized

403

Membership revoked or insufficient scope

errorstringrequired

Allowed:insufficient_scopeforbidden

404

Tenant database could not be resolved for the workspace

errorstringrequired

Allowed:workspace_not_found

500

Unexpected server error

errorstringrequired

Allowed:internal_server_error

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

cursorquerylimitquery

Request

curl -X GET 'https://connect.torqee.app/api/v1/sessions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://connect.torqee.app/api/v1/sessions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://connect.torqee.app/api/v1/sessions",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "items": [
    {
      "id": "string",
      "userId": "string",
      "userDisplayName": "string",
      "label": "string",
      "memo": "string",
      "status": "string",
      "startedAt": "string",
      "endedAt": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextCursor": "string"
}

{
  "error": "invalid_request"
}

{
  "error": "unauthorized"
}

{
  "error": "insufficient_scope"
}

{
  "error": "workspace_not_found"
}

{
  "error": "internal_server_error"
}