Skip to main content
POST
/
api
/
admin
/
histories
Retrieve conversation histories for admin users
curl --request POST \
  --url https://pria.praxislxp.com/api/admin/histories \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "institution": "<string>",
  "usersearch": "<string>",
  "account": "<string>",
  "course_name": "<string>",
  "daterange": [
    "2026-01-01",
    "2026-01-31"
  ],
  "page": 1,
  "pageSize": 1000,
  "limit": 123,
  "limitsearch": 123,
  "summary": true,
  "summaryInstruction": "<string>"
}
'
{
  "success": true,
  "data": [
    {
      "_id": "<string>",
      "credits": 123,
      "usage": 123,
      "cached": 123,
      "completion": 123,
      "latencyMs": 123,
      "ragDurationMs": 123,
      "input": "<string>",
      "inputs": [
        "<string>"
      ],
      "output": "<string>",
      "outputs": [
        "<string>"
      ],
      "success": true,
      "user": {
        "_id": "<string>",
        "email": "jsmith@example.com",
        "fname": "<string>",
        "lname": "<string>",
        "accountType": "<string>",
        "status": "<string>",
        "lxp_user_id": "<string>",
        "picture": "<string>",
        "lxp_user_type": 123,
        "lxp_partner_id": 123,
        "lxp_partner_name": "<string>",
        "lxp_role_id": 123,
        "lxp_role_name": "<string>",
        "credits": 123,
        "creditsUsed": 123,
        "plan": "<string>",
        "institution": {
          "_id": "<string>",
          "name": "<string>",
          "picture": "<string>",
          "credits": 123,
          "creditsUsed": 123,
          "creditsAwarded": 123,
          "publicId": "<string>",
          "publicAuthorizedUrls": [
            "<string>"
          ],
          "ainame": "<string>",
          "contactEmail": "<string>",
          "poolCredits": true,
          "created": "2023-11-07T05:31:56Z",
          "lastActivityAt": "2023-11-07T05:31:56Z",
          "conversationModel": "<string>",
          "account": {
            "_id": "<string>",
            "name": "<string>",
            "managerEmail": "jsmith@example.com",
            "credits": 123,
            "domainUrls": [
              "<string>"
            ],
            "qualification": "<string>",
            "created": "2023-11-07T05:31:56Z"
          },
          "agent": {
            "enabled": true,
            "preset": "<string>",
            "manifestYaml": "<string>",
            "manifestDigest": "<string>",
            "preferences": {
              "cpu": 2.125,
              "memoryMb": 4352,
              "storageGb": 52,
              "gui": true,
              "vncResolution": "1280x800"
            },
            "requestedBy": "<string>",
            "requestedAt": "2023-11-07T05:31:56Z",
            "provisionedAt": "2023-11-07T05:31:56Z",
            "lastError": "<string>"
          },
          "maxCompletionTokens": 123,
          "creditsTotal": 123,
          "creditsUsagePct": 123,
          "id": "<string>",
          "displayAgentDetails": true,
          "displayThinkingDetails": true,
          "displayThinkingExecution": true,
          "displayToolExecution": true
        },
        "remember_history_count": 123,
        "created": "2023-11-07T05:31:56Z"
      },
      "institution": {
        "_id": "<string>",
        "name": "<string>",
        "picture": "<string>",
        "credits": 123,
        "creditsUsed": 123,
        "creditsAwarded": 123,
        "publicId": "<string>",
        "publicAuthorizedUrls": [
          "<string>"
        ],
        "ainame": "<string>",
        "contactEmail": "<string>",
        "poolCredits": true,
        "created": "2023-11-07T05:31:56Z",
        "lastActivityAt": "2023-11-07T05:31:56Z",
        "conversationModel": "<string>",
        "account": {
          "_id": "<string>",
          "name": "<string>",
          "managerEmail": "jsmith@example.com",
          "credits": 123,
          "domainUrls": [
            "<string>"
          ],
          "qualification": "<string>",
          "created": "2023-11-07T05:31:56Z"
        },
        "agent": {
          "enabled": true,
          "preset": "<string>",
          "manifestYaml": "<string>",
          "manifestDigest": "<string>",
          "preferences": {
            "cpu": 2.125,
            "memoryMb": 4352,
            "storageGb": 52,
            "gui": true,
            "vncResolution": "1280x800"
          },
          "requestedBy": "<string>",
          "requestedAt": "2023-11-07T05:31:56Z",
          "provisionedAt": "2023-11-07T05:31:56Z",
          "lastError": "<string>"
        },
        "maxCompletionTokens": 123,
        "creditsTotal": 123,
        "creditsUsagePct": 123,
        "id": "<string>",
        "displayAgentDetails": true,
        "displayThinkingDetails": true,
        "displayThinkingExecution": true,
        "displayToolExecution": true
      },
      "status": "<string>",
      "query_duration_ms": 123,
      "course_id": 123,
      "course_name": "<string>",
      "assistant": {
        "_id": "<string>",
        "name": "<string>"
      },
      "conversation_model": "<string>",
      "tools": [
        {
          "id": "<string>",
          "name": "<string>",
          "responseLength": 123,
          "responseDurationMs": 123,
          "success": true,
          "_id": "<string>",
          "description": "<string>",
          "instructions": "<string>",
          "argument_1": "<string>",
          "argument_2": "<string>",
          "argument_3": "<string>",
          "argument_4": "<string>",
          "argument_5": "<string>",
          "argument_6": "<string>",
          "isArray": false,
          "rtEnabled": false,
          "rtOnly": false,
          "categories": [],
          "status": "active",
          "created": "2023-11-07T05:31:56Z",
          "unavailable": true,
          "unavailableReason": "<string>"
        }
      ],
      "created": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "hasMore": true,
  "page": 123,
  "pageSize": 123,
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
​
institution
string

Institution ID to filter histories (space-separated for multiple)

​
usersearch
string

Search term to filter by user email, first name, or last name

​
account
string

Account ID to filter by account's institutions (space-separated for multiple)

​
accountType
enum<string>

Filter by user account type

Available options:
user,
admin,
super
​
course_name
string

Filter by course name (case-insensitive partial match)

​
daterange
(string<date> | null)[]

Date range filter as [startDate, endDate]. Defaults to last 30 days if not provided. Use null for open-ended ranges.

Required array length: 2 elements
Example:
["2026-01-01", "2026-01-31"]
​
page
integer
default:1

Page number for pagination (1-based)

Required range: x >= 1
​
pageSize
integer
default:1000

Number of records per page (max 5000). Default 1000 for backward compatibility.

Required range: 1 <= x <= 5000
​
limit
integer
deprecated

Deprecated: use 'pageSize' instead.

​
limitsearch
integer
deprecated

Deprecated: use 'pageSize' instead.

​
summary
boolean

When true, returns an AI-generated summary instead of raw data

​
summaryInstruction
string

Custom instruction for the AI summary generation

Response

Successfully retrieved conversation histories

​
success
boolean
​
data
object[]
​
total
integer

Total number of matching records across all pages

​
hasMore
boolean

Whether more pages exist beyond the current page

​
page
integer

Current page number (1-based)

​
pageSize
integer

Records per page (resolved/clamped value)

​
message
string