Skip to main content

Summary

Fetch activity history for a specific user, including session duration, message count, and detailed session logs with date filtering.

Request

GET https://api.planetaryapp.us/v1/workspace/{workspace_id}/user/{user_id}/activity

Query Parameters

ParameterTypeDescription
startDateISO 8601Filter by start date (e.g., 2024-01-01T00:00:00Z)
endDateISO 8601Filter by end date (e.g., 2024-01-31T23:59:59Z)
pagenumberPage number (default: 1)
limitnumberItems per page (default: 50, max: 100)

Response example

{
  "success": true,
  "user": {
    "userId": 123456,
    "username": "john_doe",
    "displayName": "John Doe",
    "thumbnail": "https://example.com/avatar.png"
  },
  "activity": {
    "totalSessions": 42,
    "totalDuration": 151200,
    "averageDuration": 3600,
    "totalMessages": 1024,
    "sessions": [
      {
        "id": "clz1234abcd",
        "startTime": "2024-01-01T00:00:00Z",
        "endTime": "2024-01-01T01:00:00Z",
        "duration": 3600,
        "messages": 42
      }
    ]
  },
  "page": 1,
  "limit": 50,
  "pages": 1
}